語言

EntityFrameworkServiceCollectionExtensions.AddDbContext 方法

定義

多載

名稱 Description
AddDbContext<TContext>(IServiceCollection, ServiceLifetime)

將給定上下文註冊為 中的服務。IServiceCollection 當你的應用程式中使用依賴注入時,例如使用 ASP.NET 時,你會使用此方法。 關於如何設定依賴注入的更多資訊,請參見 http://go.microsoft.com/fwlink/?LinkId=526890。

AddDbContext<TContext>(IServiceCollection, ServiceLifetime, ServiceLifetime)

將給定上下文註冊為 中的服務。IServiceCollection

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

將給定上下文註冊為 中的服務。IServiceCollection 當你的應用程式中使用依賴注入時,例如使用 ASP.NET 時,你會使用此方法。 關於如何設定依賴注入的更多資訊,請參見 http://go.microsoft.com/fwlink/?LinkId=526890。

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。

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

將給定上下文註冊為 中的服務。IServiceCollection

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

將給定上下文註冊為 中的服務。IServiceCollection

AddDbContext<TContextService,TContextImplementation>(IServiceCollection, ServiceLifetime, ServiceLifetime)

將給定上下文註冊為 中的服務。IServiceCollection

AddDbContext<TContextService,TContextImplementation>(IServiceCollection, Action<DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime)

將給定上下文註冊為 中的服務。IServiceCollection

AddDbContext<TContextService,TContextImplementation>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, ServiceLifetime, ServiceLifetime)

將給定上下文註冊為 中的服務。IServiceCollection

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)

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

將給定上下文註冊為 中的服務。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)

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

將給定上下文註冊為 中的服務。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)

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

將給定上下文註冊為 中的服務。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)

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

將給定上下文註冊為 中的服務。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)

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

將給定上下文註冊為 中的服務。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)

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

將給定上下文註冊為 中的服務。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 。

適用於