EntityFrameworkServiceCollectionExtensions.AddDbContext 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
AddDbContext<TContext>(IServiceCollection, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection 當你的應用程式中使用依賴注入時,例如使用 ASP.NET 時,你會使用此方法。 關於如何設定依賴注入的更多資訊,請參見 http://go.microsoft.com/fwlink/?LinkId=526890。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContext(Of TContext As DbContext) (serviceCollection As IServiceCollection, contextLifetime As ServiceLifetime) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services.AddDbContext<MyContext>(ServiceLifetime.Scoped);
}
適用於
AddDbContext<TContext>(IServiceCollection, ServiceLifetime, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Microsoft.Extensions.DependencyInjection.ServiceLifetime * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContext(Of TContext As DbContext) (serviceCollection As IServiceCollection, contextLifetime As ServiceLifetime, Optional optionsLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
- optionsLifetime
- ServiceLifetime
即在容器中註冊 DbContextOptions 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services.AddDbContext<MyContext>(ServiceLifetime.Scoped);
}
備註
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參見 使用 DbContext 與依賴注入 。
適用於
AddDbContext<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection 當你的應用程式中使用依賴注入時,例如使用 ASP.NET 時,你會使用此方法。 關於如何設定依賴注入的更多資訊,請參見 http://go.microsoft.com/fwlink/?LinkId=526890。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContext(Of TContext As DbContext) (serviceCollection As IServiceCollection, Optional optionsAction As Action(Of DbContextOptionsBuilder) = Nothing, Optional contextLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<DbContextOptionsBuilder>
一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。
若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。
為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services.AddDbContext<MyContext>(options => options.UseSqlServer(connectionString));
}
適用於
AddDbContext<TContext>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection 當你的應用程式中使用依賴注入時,例如使用 ASP.NET 時,你會使用此方法。 關於如何設定依賴注入,請參見 http://go.microsoft.com/fwlink/?LinkId=526890.
此過載具有 optionsAction ,提供應用 IServiceProvider。
如果你想設定 Entity Framework 來解析主要應用服務提供者的內部服務,這很有用。
預設情況下,我們建議使用另一個超載,允許 Entity Framework 為內部 Entity Framework 服務建立並維護自己的 IServiceProvider overload。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContext : 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 AddDbContext(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional contextLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<IServiceProvider,DbContextOptionsBuilder>
一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。
若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。
為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services
.AddEntityFrameworkSqlServer()
.AddDbContext<MyContext>((serviceProvider, options) =>
options.UseSqlServer(connectionString)
.UseInternalServiceProvider(serviceProvider));
}
適用於
AddDbContext<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContext(Of TContext As DbContext) (serviceCollection As IServiceCollection, Optional optionsAction As Action(Of DbContextOptionsBuilder) = Nothing, Optional contextLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Optional optionsLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<DbContextOptionsBuilder>
一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。
若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。
為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
- optionsLifetime
- ServiceLifetime
即在容器中註冊 DbContextOptions 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services.AddDbContext<MyContext>(options => options.UseSqlServer(connectionString));
}
備註
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參見 使用 DbContext 與依賴注入 。
適用於
AddDbContext<TContext>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<IServiceProvider, Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContext(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional contextLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Optional optionsLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<IServiceProvider,DbContextOptionsBuilder>
一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。
若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。
為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
- optionsLifetime
- ServiceLifetime
即在容器中註冊 DbContextOptions 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services
.AddEntityFrameworkSqlServer()
.AddDbContext<MyContext>((serviceProvider, options) =>
options.UseSqlServer(connectionString)
.UseInternalServiceProvider(serviceProvider));
}
備註
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參見 使用 DbContext 與依賴注入 。
此過載具有 optionsAction ,為應用程式 IServiceProvider提供 。 如果你想設定 Entity Framework Core,從主要應用程式服務提供者那裡解析其內部服務,這很有用。 預設情況下,我們建議使用 AddDbContext<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime) Entity Framework 為內部 Entity Framework 建立並維護服務 IServiceProvider 。
適用於
AddDbContext<TContextService,TContextImplementation>(IServiceCollection, ServiceLifetime, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContextService : class where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Microsoft.Extensions.DependencyInjection.ServiceLifetime * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'ContextService : null and 'ContextImplementation :> Microsoft.EntityFrameworkCore.DbContext and 'ContextImplementation :> 'ContextService)
<Extension()>
Public Function AddDbContext(Of TContextService As Class, TContextImplementation As Class) (serviceCollection As IServiceCollection, contextLifetime As ServiceLifetime, Optional optionsLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContextService
用來解析容器上下文的類別或介面。
- TContextImplementation
具體的實作類型來創造。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
- optionsLifetime
- ServiceLifetime
即在容器中註冊 DbContextOptions 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services.AddDbContext<MyContext>(ServiceLifetime.Scoped);
}
備註
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參見 使用 DbContext 與依賴注入 。
適用於
AddDbContext<TContextService,TContextImplementation>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction = default, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'ContextImplementation :> Microsoft.EntityFrameworkCore.DbContext and 'ContextImplementation :> 'ContextService)
<Extension()>
Public Function AddDbContext(Of TContextService, TContextImplementation) (serviceCollection As IServiceCollection, Optional optionsAction As Action(Of DbContextOptionsBuilder) = Nothing, Optional contextLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Optional optionsLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContextService
用來解析容器上下文的類別或介面。
- TContextImplementation
具體的實作類型來創造。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<DbContextOptionsBuilder>
一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。
若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。
為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
- optionsLifetime
- ServiceLifetime
即在容器中註冊 DbContextOptions 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services.AddDbContext<MyContext>(options => options.UseSqlServer(connectionString));
}
備註
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參見 使用 DbContext 與依賴注入 。
適用於
AddDbContext<TContextService,TContextImplementation>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime)
將給定上下文註冊為 中的服務。IServiceCollection
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder>? optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContext<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, Microsoft.Extensions.DependencyInjection.ServiceLifetime contextLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Microsoft.Extensions.DependencyInjection.ServiceLifetime optionsLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
static member AddDbContext : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<IServiceProvider, Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * Microsoft.Extensions.DependencyInjection.ServiceLifetime * Microsoft.Extensions.DependencyInjection.ServiceLifetime -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'ContextImplementation :> Microsoft.EntityFrameworkCore.DbContext and 'ContextImplementation :> 'ContextService)
<Extension()>
Public Function AddDbContext(Of TContextService, TContextImplementation) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional contextLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped, Optional optionsLifetime As ServiceLifetime = Microsoft.Extensions.DependencyInjection.ServiceLifetime.Scoped) As IServiceCollection
類型參數
- TContextService
用來解析容器上下文的類別或介面。
- TContextImplementation
具體的實作類型來創造。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<IServiceProvider,DbContextOptionsBuilder>
一個可選的動作,用來設定 以 DbContextOptions 符合上下文。 這提供了一種替代方案,不用在導出上下文中覆寫該 OnConfiguring(DbContextOptionsBuilder) 方法來設定上下文。
若此處提供動作, OnConfiguring(DbContextOptionsBuilder) 且該方法已被在衍生上下文中覆寫,仍會執行。 OnConfiguring(DbContextOptionsBuilder) 除了這裡執行的配置外,也會進行配置。
為了讓選項被傳遞到你的上下文中,你需要在上下文上暴露一個構造子,將 DbContextOptions<TContext> 該構造子傳遞給 的 DbContext基底構造子。
- contextLifetime
- ServiceLifetime
在容器中註冊 DbContext 服務的壽命。
- optionsLifetime
- ServiceLifetime
即在容器中註冊 DbContextOptions 服務的壽命。
傳回
相同的服務集合,讓多通通話可以串聯起來。
範例
public void ConfigureServices(IServiceCollection services)
{
var connectionString = "connection string to database";
services
.AddEntityFrameworkSqlServer()
.AddDbContext<MyContext>((serviceProvider, options) =>
options.UseSqlServer(connectionString)
.UseInternalServiceProvider(serviceProvider));
}
備註
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參見 使用 DbContext 與依賴注入 。
此過載具有 optionsAction ,為應用程式 IServiceProvider提供 。 如果你想設定 Entity Framework Core,從主要應用程式服務提供者那裡解析其內部服務,這很有用。 預設情況下,我們建議使用 AddDbContext<TContextService,TContextImplementation>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime) Entity Framework 為內部 Entity Framework 建立並維護服務 IServiceProvider 。