語言

EntityFrameworkServiceCollectionExtensions.AddDbContextFactory 方法

定義

多載

名稱 Description
AddDbContextFactory<TContext,TFactory>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime)

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

AddDbContextFactory<TContext,TFactory>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime)

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

AddDbContextFactory<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime)

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

AddDbContextFactory<TContext>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime)

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

AddDbContextFactory<TContext,TFactory>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime)

來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext,TFactory>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext where TFactory : Microsoft.EntityFrameworkCore.IDbContextFactory<TContext>;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext,TFactory>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext where TFactory : Microsoft.EntityFrameworkCore.IDbContextFactory<TContext>;
static member AddDbContextFactory : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<IServiceProvider, Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext and 'Factory :> Microsoft.EntityFrameworkCore.IDbContextFactory<'Context>)
<Extension()>
Public Function AddDbContextFactory(Of TContext As DbContext, TFactory As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional lifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) As IServiceCollection

類型參數

TContext

由工廠生產的類型 DbContext 。

TFactory

登記的類型 IDbContextFactory<TContext> 。

參數

serviceCollection
IServiceCollection

IServiceCollection新增服務。

optionsAction
Action<IServiceProvider,DbContextOptionsBuilder>

一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。

若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。

為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。

lifetime
ServiceLifetime

註冊工廠及選項的使用壽命。 預設值為 Singleton

傳回

相同的服務集合,讓多通通話可以串聯起來。

備註

註冊工廠而非直接註冊上下文類型,方便建立新 DbContext 實例。 建議在 Blazor 應用程式及其他相依注入範圍與上下文壽命不符的情況下註冊工廠。

在應用中使用依賴注入時,例如使用 Blazor,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。

為了方便起見,此方法同時將上下文類型本身註冊為有作用域的服務。 這允許上下文實例直接從依賴注入範圍解析,或由工廠依情況建立。

這種過載讓特定實作 IDbContextFactory<TContext> 可以註冊,而非使用 EF Core 預設的出廠版本。

此過載具有 optionsAction ,為應用程式 IServiceProvider提供 。 如果你想設定 Entity Framework Core,從主要應用程式服務提供者那裡解析其內部服務,這很有用。 預設情況下,我們建議使用 AddDbContextFactory<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime) Entity Framework 為內部 Entity Framework 建立並維護服務 IServiceProvider 。

Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參見 使用 DbContext 與依賴注入 及 使用 DbContext 工廠 。

適用於

AddDbContextFactory<TContext,TFactory>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime)

來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext,TFactory>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext where TFactory : Microsoft.EntityFrameworkCore.IDbContextFactory<TContext>;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext,TFactory>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext where TFactory : Microsoft.EntityFrameworkCore.IDbContextFactory<TContext>;
static member AddDbContextFactory : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext and 'Factory :> Microsoft.EntityFrameworkCore.IDbContextFactory<'Context>)
<Extension()>
Public Function AddDbContextFactory(Of TContext As DbContext, TFactory As DbContext) (serviceCollection As IServiceCollection, Optional optionsAction As Action(Of DbContextOptionsBuilder) = Nothing, Optional lifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) As IServiceCollection

類型參數

TContext

由工廠生產的類型 DbContext 。

TFactory

登記的類型 IDbContextFactory<TContext> 。

參數

serviceCollection
IServiceCollection

IServiceCollection新增服務。

optionsAction
Action<DbContextOptionsBuilder>

一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。

若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。

為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。

lifetime
ServiceLifetime

註冊工廠及選項的使用壽命。 預設值為 Singleton

傳回

相同的服務集合,讓多通通話可以串聯起來。

備註

註冊工廠而非直接註冊上下文類型,方便建立新 DbContext 實例。 建議在 Blazor 應用程式及其他相依注入範圍與上下文壽命不符的情況下註冊工廠。

在應用中使用依賴注入時,例如使用 Blazor,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。

為了方便起見,此方法同時將上下文類型本身註冊為有作用域的服務。 這允許上下文實例直接從依賴注入範圍解析,或由工廠依情況建立。

這種過載讓特定實作 IDbContextFactory<TContext> 可以註冊,而非使用 EF Core 預設的出廠版本。

Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參見 使用 DbContext 與依賴注入 及 使用 DbContext 工廠 。

適用於

AddDbContextFactory<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime)

來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContextFactory : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContextFactory(Of TContext As DbContext) (serviceCollection As IServiceCollection, Optional optionsAction As Action(Of DbContextOptionsBuilder) = Nothing, Optional lifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) As IServiceCollection

類型參數

TContext

由工廠生產的類型 DbContext 。

參數

serviceCollection
IServiceCollection

IServiceCollection新增服務。

optionsAction
Action<DbContextOptionsBuilder>

一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。

若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。

為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。

lifetime
ServiceLifetime

註冊工廠及選項的使用壽命。 預設值為 Singleton

傳回

相同的服務集合,讓多通通話可以串聯起來。

備註

註冊工廠而非直接註冊上下文類型,方便建立新 DbContext 實例。 建議在 Blazor 應用程式及其他相依注入範圍與上下文壽命不符的情況下註冊工廠。

在應用中使用依賴注入時,例如使用 Blazor,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。

為了方便起見,此方法同時將上下文類型本身註冊為有作用域的服務。 這允許上下文實例直接從依賴注入範圍解析,或由工廠依情況建立。

Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參見 使用 DbContext 與依賴注入 及 使用 DbContext 工廠 。

適用於

AddDbContextFactory<TContext>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime)

來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs
來源:
EntityFrameworkServiceCollectionExtensions.cs

在 中註冊 並IDbContextFactory<TContext>IServiceCollection建立給定DbContext類型的實例。

public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextFactory<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime lifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContextFactory : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<IServiceProvider, Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContextFactory(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional lifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Singleton) As IServiceCollection

類型參數

TContext

由工廠生產的類型 DbContext 。

參數

serviceCollection
IServiceCollection

IServiceCollection新增服務。

optionsAction
Action<IServiceProvider,DbContextOptionsBuilder>

一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。

若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。

為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。

lifetime
ServiceLifetime

註冊工廠及選項的使用壽命。 預設值為 Singleton

傳回

相同的服務集合,讓多通通話可以串聯起來。

備註

註冊工廠而非直接註冊上下文類型,方便建立新 DbContext 實例。 建議在 Blazor 應用程式及其他相依注入範圍與上下文壽命不符的情況下註冊工廠。

在應用中使用依賴注入時,例如使用 Blazor,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。

為了方便起見,此方法同時將上下文類型本身註冊為有作用域的服務。 這允許上下文實例直接從依賴注入範圍解析,或由工廠依情況建立。

此過載具有 optionsAction ,為應用程式 IServiceProvider提供 。 如果你想設定 Entity Framework Core,從主要應用程式服務提供者那裡解析其內部服務,這很有用。 預設情況下,我們建議使用 AddDbContextFactory<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime) Entity Framework 為內部 Entity Framework 建立並維護服務 IServiceProvider 。

Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。

更多資訊與範例請參見 使用 DbContext 與依賴注入 及 使用 DbContext 工廠 。

適用於