EntityFrameworkServiceCollectionExtensions.AddDbContextPool 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| AddDbContextPool<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, Int32) |
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。 |
| AddDbContextPool<TContext>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, Int32) |
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。 |
| AddDbContextPool<TContextService,TContextImplementation>(IServiceCollection, Action<DbContextOptionsBuilder>, Int32) |
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。 |
| AddDbContextPool<TContextService,TContextImplementation>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, Int32) |
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。 |
AddDbContextPool<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, Int32)
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 1024) where TContext : Microsoft.EntityFrameworkCore.DbContext;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 128) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContextPool : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * int -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContextPool(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of DbContextOptionsBuilder), Optional poolSize As Integer = 1024) As IServiceCollection
<Extension()>
Public Function AddDbContextPool(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of DbContextOptionsBuilder), Optional poolSize As Integer = 128) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<DbContextOptionsBuilder>
這是設定 DbContextOptions 上下文所需的動作。 使用上下文池時,選項配置必須在外部執行; OnConfiguring(DbContextOptionsBuilder) 不會被召喚。
- poolSize
- Int32
設定池中保留的最大實例數。 預設為1024。
傳回
相同的服務集合,讓多通通話可以串聯起來。
備註
DbContext 池化可透過重複使用上下文實例,在高吞吐量情境下提升效能。 然而,對大多數應用來說,這種效能提升非常小。 請注意,使用池化時,上下文設定不能在使用間改變,且注入上下文的範圍服務只會從初始範圍解析一次。 只有在效能測試顯示資料庫上下文池能帶來實質提升時,才考慮使用它。
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 《Using DbContext with dependency injection 》及 《Using DbContext pooling 》。
適用於
AddDbContextPool<TContext>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, Int32)
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 1024) where TContext : Microsoft.EntityFrameworkCore.DbContext;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContext>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 128) where TContext : Microsoft.EntityFrameworkCore.DbContext;
static member AddDbContextPool : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<IServiceProvider, Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * int -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)
<Extension()>
Public Function AddDbContextPool(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional poolSize As Integer = 1024) As IServiceCollection
<Extension()>
Public Function AddDbContextPool(Of TContext As DbContext) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional poolSize As Integer = 128) As IServiceCollection
類型參數
- TContext
要登記的情境類型。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<IServiceProvider,DbContextOptionsBuilder>
這是設定 DbContextOptions 上下文所需的動作。 使用上下文池時,選項配置必須在外部執行; OnConfiguring(DbContextOptionsBuilder) 不會被召喚。
- poolSize
- Int32
設定池中保留的最大實例數。 預設為1024。
傳回
相同的服務集合,讓多通通話可以串聯起來。
備註
DbContext 池化可透過重複使用上下文實例,在高吞吐量情境下提升效能。 然而,對大多數應用來說,這種效能提升非常小。 請注意,使用池化時,上下文設定不能在使用間改變,且注入上下文的範圍服務只會從初始範圍解析一次。 只有在效能測試顯示資料庫上下文池能帶來實質提升時,才考慮使用它。
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 《Using DbContext with dependency injection 》及 《Using DbContext pooling 》。
此過載具有 optionsAction ,為應用程式 IServiceProvider提供 。 如果你想設定 Entity Framework Core,從主要應用程式服務提供者那裡解析其內部服務,這很有用。 預設情況下,我們建議使用 AddDbContextPool<TContext>(IServiceCollection, Action<DbContextOptionsBuilder>, Int32) Entity Framework 為內部 Entity Framework 建立並維護服務 IServiceProvider 。
適用於
AddDbContextPool<TContextService,TContextImplementation>(IServiceCollection, Action<DbContextOptionsBuilder>, Int32)
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 1024) where TContextService : class where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 128) where TContextService : class where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
static member AddDbContextPool : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * int -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'ContextService : null and 'ContextImplementation :> Microsoft.EntityFrameworkCore.DbContext and 'ContextImplementation :> 'ContextService)
<Extension()>
Public Function AddDbContextPool(Of TContextService As Class, TContextImplementation As Class) (serviceCollection As IServiceCollection, optionsAction As Action(Of DbContextOptionsBuilder), Optional poolSize As Integer = 1024) As IServiceCollection
<Extension()>
Public Function AddDbContextPool(Of TContextService As Class, TContextImplementation As Class) (serviceCollection As IServiceCollection, optionsAction As Action(Of DbContextOptionsBuilder), Optional poolSize As Integer = 128) As IServiceCollection
類型參數
- TContextService
用來解析容器上下文的類別或介面。
- TContextImplementation
具體的實作類型來創造。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<DbContextOptionsBuilder>
這是設定 DbContextOptions 上下文所需的動作。 使用上下文池時,選項配置必須在外部執行; OnConfiguring(DbContextOptionsBuilder) 不會被召喚。
- poolSize
- Int32
設定池中保留的最大實例數。 預設為1024。
傳回
相同的服務集合,讓多通通話可以串聯起來。
備註
DbContext 池化可透過重複使用上下文實例,在高吞吐量情境下提升效能。 然而,對大多數應用來說,這種效能提升非常小。 請注意,使用池化時,上下文設定不能在使用間改變,且注入上下文的範圍服務只會從初始範圍解析一次。 只有在效能測試顯示資料庫上下文池能帶來實質提升時,才考慮使用它。
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 《Using DbContext with dependency injection 》及 《Using DbContext pooling 》。
適用於
AddDbContextPool<TContextService,TContextImplementation>(IServiceCollection, Action<IServiceProvider,DbContextOptionsBuilder>, Int32)
將該服務 DbContext 註冊為 IServiceCollection服務,並啟用 DbContext 池化。
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 1024) where TContextService : class where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
public static Microsoft.Extensions.DependencyInjection.IServiceCollection AddDbContextPool<TContextService,TContextImplementation>(this Microsoft.Extensions.DependencyInjection.IServiceCollection serviceCollection, Action<IServiceProvider,Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> optionsAction, int poolSize = 128) where TContextService : class where TContextImplementation : Microsoft.EntityFrameworkCore.DbContext, TContextService;
static member AddDbContextPool : Microsoft.Extensions.DependencyInjection.IServiceCollection * Action<IServiceProvider, Microsoft.EntityFrameworkCore.DbContextOptionsBuilder> * int -> Microsoft.Extensions.DependencyInjection.IServiceCollection (requires 'ContextService : null and 'ContextImplementation :> Microsoft.EntityFrameworkCore.DbContext and 'ContextImplementation :> 'ContextService)
<Extension()>
Public Function AddDbContextPool(Of TContextService As Class, TContextImplementation As Class) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional poolSize As Integer = 1024) As IServiceCollection
<Extension()>
Public Function AddDbContextPool(Of TContextService As Class, TContextImplementation As Class) (serviceCollection As IServiceCollection, optionsAction As Action(Of IServiceProvider, DbContextOptionsBuilder), Optional poolSize As Integer = 128) As IServiceCollection
類型參數
- TContextService
用來解析容器上下文的類別或介面。
- TContextImplementation
具體的實作類型來創造。
參數
- serviceCollection
- IServiceCollection
IServiceCollection新增服務。
- optionsAction
- Action<IServiceProvider,DbContextOptionsBuilder>
這是設定 DbContextOptions 上下文所需的動作。 使用上下文池時,選項配置必須在外部執行; OnConfiguring(DbContextOptionsBuilder) 不會被召喚。
- poolSize
- Int32
設定池中保留的最大實例數。 預設為1024。
傳回
相同的服務集合,讓多通通話可以串聯起來。
備註
DbContext 池化可透過重複使用上下文實例,在高吞吐量情境下提升效能。 然而,對大多數應用來說,這種效能提升非常小。 請注意,使用池化時,上下文設定不能在使用間改變,且注入上下文的範圍服務只會從初始範圍解析一次。 只有在效能測試顯示資料庫上下文池能帶來實質提升時,才考慮使用它。
在應用程式中使用依賴注入時,例如使用 ASP.NET Core,請使用此方法。 對於不使用依賴注入的應用程式,可以考慮直接用其建構子建立 DbContext 實例。 接著可以覆寫該OnConfiguring(DbContextOptionsBuilder)方法來配置 連接字串 及其他選項。
Entity Framework Core 不支援在同一 DbContext 執行個體上執行多個平行作業。 這包括平行執行非同步查詢,以及明確同時使用多個執行緒。 因此,務必立即等待非同步呼叫,或使用獨立的 DbContext 實例來執行平行執行的操作。 更多資訊與範例請參見 「避免 DbContext 執行緒問題 」。
更多資訊與範例請參閱 《Using DbContext with dependency injection 》及 《Using DbContext pooling 》。
此過載具有 optionsAction ,為應用程式 IServiceProvider提供 。 如果你想設定 Entity Framework Core,從主要應用程式服務提供者那裡解析其內部服務,這很有用。 預設情況下,我們建議使用 AddDbContextPool<TContextService,TContextImplementation>(IServiceCollection, Action<DbContextOptionsBuilder>, Int32) Entity Framework 為內部 Entity Framework 建立並維護服務 IServiceProvider 。