语言

EntityFrameworkServiceCollectionExtensions.AddDbContextFactory 方法

定义

重载

名称 说明
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)

Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
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 和 Using DbContext 工厂 。

适用于

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

Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
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 和 Using DbContext 工厂 。

适用于

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

Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
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 和 Using DbContext 工厂 。

适用于

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

Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
EntityFrameworkServiceCollectionExtensions.cs
Source:
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 和 Using DbContext 工厂 。

适用于