DbContextOptionsBuilder 類別

定義

命名空間:

Microsoft.EntityFrameworkCore

組件:

Microsoft.EntityFrameworkCore.dll

套件:

Microsoft.EntityFrameworkCore v8.0.0

提供用於設定 DbContextOptions 的簡單 API 介面。 資料庫 (和其他延伸模組) 通常會在此物件上定義擴充方法，讓您設定資料庫連接 (和其他選項，) 用於內容。

public class DbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsBuilderInfrastructure

type DbContextOptionsBuilder = class
    interface IDbContextOptionsBuilderInfrastructure

Public Class DbContextOptionsBuilder
Implements IDbContextOptionsBuilderInfrastructure

繼承

Object

DbContextOptionsBuilder

衍生

Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext>

實作

IDbContextOptionsBuilderInfrastructure

備註

您可以使用 DbContextOptionsBuilder 來設定內容，方法是覆 OnConfiguring(DbContextOptionsBuilder) 寫或建立 DbContextOptions 外部，並將它傳遞至內容建構函式。

如需詳細資訊和範例 ，請參閱使用 DbCoNtextOptions 。

建構函式

DbContextOptionsBuilder()	初始化 未設定任何選項之 DbContextOptionsBuilder 類別的新實例。
DbContextOptionsBuilder(DbContextOptions)	初始化 類別的新實例， DbContextOptionsBuilder 以進一步設定指定的 DbContextOptions 。

屬性

IsConfigured	取得值，指出是否已設定任何選項。
Options	取得正在設定的選項。

方法

AddInterceptors(IEnumerable<IInterceptor>)	將 IInterceptor 實例加入至在內容上註冊的實例。
AddInterceptors(IInterceptor[])	將 IInterceptor 實例加入至在內容上註冊的實例。
ConfigureLoggingCacheTime(TimeSpan)	設定 EF Core 在特定高效能路徑中快取記錄設定的時間長度。 這會使 EF Core 略過可能耗費成本的記錄檢查，但表示執行時間記錄變更 (例如，註冊新的 DiagnosticListener 可能不會立即納入考慮) 。
ConfigureWarnings(Action<WarningsConfigurationBuilder>)	設定 Entity Framework 所產生的警告執行時間行為。 您可以為每個警告類型設定預設行為和行為。
EnableDetailedErrors(Boolean)	在處理存放區查詢結果期間發生的資料值例外狀況時，啟用詳細的錯誤。 這類錯誤最常因為實體屬性設定錯誤而發生。 例如，如果屬性設定為類型為 'int'，但存放區中的基礎資料實際上是類型 'string'，則在處理資料值期間，會在執行時間產生例外狀況。 啟用此選項並遇到資料錯誤時，產生的例外狀況將會包含產生錯誤之特定實體屬性的詳細資料。
EnableSensitiveDataLogging(Boolean)	可讓應用程式資料包含在例外狀況訊息、記錄等中。這可以包含指派給實體實例屬性的值、傳送至資料庫的命令參數值，以及其他這類資料。 只有根據此資料的敏感度，才應該啟用此旗標。
EnableServiceProviderCaching(Boolean)	啟用或停用內部服務提供者的快取。 停用快取可能會大幅影響效能，而且只應用於建置許多服務提供者以進行測試隔離的測試案例。
EnableThreadSafetyChecks(Boolean)	停用並行偵測，它會偵測實例的多個錯誤並行使用 DbContext 案例，並導致擲回信息例外狀況。 這會提供一些效能改善，但如果 DbContext 同時使用 實例，行為將會未定義，而且程式可能會以無法預期的方式失敗。
LogTo(Action<String>, Func<EventId,LogLevel,Boolean>, Nullable<DbContextLoggerOptions>)	記錄由提供的自訂篩選委派篩選的事件。 篩選準則應該會傳回 true 來記錄訊息，或傳回 false 以將它篩選掉記錄檔。
LogTo(Action<String>, IEnumerable<EventId>, LogLevel, Nullable<DbContextLoggerOptions>)	使用提供的動作記錄指定的事件。 例如，使用 optionsBuilder.LogTo(Console.WriteLine, new[] { CoreEventId.ContextInitialized }) 將事件記錄 ContextInitialized 到主控台。
LogTo(Action<String>, IEnumerable<String>, LogLevel, Nullable<DbContextLoggerOptions>)	使用提供的動作，記錄指定類別中的所有事件。 例如，使用 optionsBuilder.LogTo(Console.WriteLine, new[] { DbLoggerCategory.Infrastructure.Name }) 來記錄類別中的所有 DbLoggerCategory.Infrastructure 事件。
LogTo(Action<String>, LogLevel, Nullable<DbContextLoggerOptions>)	使用提供的動作記錄。 例如，使用 optionsBuilder.LogTo(Console.WriteLine) 來登入主控台。
LogTo(Func<EventId,LogLevel,Boolean>, Action<EventData>)	將事件記錄至自訂篩選委派篩選的自訂記錄器委派。 篩選準則應該會傳回 true 來記錄訊息，或傳回 false 以將它篩選掉記錄檔。
ReplaceService<TService,TCurrentImplementation,TNewImplementation>()	以不同的實作取代服務合約特定實作的內部 Entity Framework 實作。
ReplaceService<TService,TImplementation>()	以不同的實作取代服務合約的所有內部 Entity Framework 實作。
UseApplicationServiceProvider(IServiceProvider)	IServiceProvider設定要從中取得應用程式服務的 。 使用 'AddDbCoNtext' 或 'AddDbCoNtextPool' 時，這會自動完成，因此很少需要呼叫這個方法。
UseInternalServiceProvider(IServiceProvider)	IServiceProvider設定內容應該從中解析其所有服務的 。 如果未指定，EF 將會建立和管理服務提供者。
UseLoggerFactory(ILoggerFactory)	ILoggerFactory設定 ，用來建立 ILogger 實例以供此內容完成的記錄。
UseMemoryCache(IMemoryCache)	IMemoryCache設定要用於此內容之查詢快取的 。
UseModel(IModel)	設定要用於內容的模型。 如果已設定模型， OnModelCreating(ModelBuilder) 則不會執行。
UseQueryTrackingBehavior(QueryTrackingBehavior)	設定針對內容執行的 LINQ 查詢追蹤行為。 停用變更追蹤對於唯讀案例很有用，因為它可避免為每個實體實例設定變更追蹤的額外負荷。 如果您想要操作實體實例，並使用 將那些變更保存到資料庫 SaveChanges() ，則不應該停用變更追蹤。
UseRootApplicationServiceProvider()	從範圍應用程式服務提供者解析根 IServiceProvider 目錄。 根提供者可用來從單一內部服務取得單一應用程式服務。
UseRootApplicationServiceProvider(IServiceProvider)	設定單一應用程式服務可從單一內部服務取得的根 IServiceProvider 目錄。

明確介面實作

IDbContextOptionsBuilderInfrastructure.AddOrUpdateExtension<TExtension>(TExtension)

將指定的延伸模組新增至選項。 如果已經存在相同類型的現有延伸模組，則會加以取代。

擴充方法

UseCosmos(DbContextOptionsBuilder, String, TokenCredential, String, Action<CosmosDbContextOptionsBuilder>)	設定內容以連線到 Azure Cosmos 資料庫。
UseCosmos(DbContextOptionsBuilder, String, String, Action<CosmosDbContextOptionsBuilder>)	設定內容以連線到 Azure Cosmos 資料庫。
UseCosmos(DbContextOptionsBuilder, String, String, String, Action<CosmosDbContextOptionsBuilder>)	設定內容以連線到 Azure Cosmos 資料庫。
UseInMemoryDatabase(DbContextOptionsBuilder, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>)	設定內容以連線到具名記憶體內部資料庫。 記憶體內部資料庫會在使用相同名稱的任何位置共用，但僅適用于指定的服務提供者。
UseInMemoryDatabase(DbContextOptionsBuilder, String, Action<InMemoryDbContextOptionsBuilder>)	設定內容以連線到具名記憶體內部資料庫。 記憶體內部資料庫會在使用相同名稱的任何位置共用，但僅適用于指定的服務提供者。 若要跨服務提供者使用相同的記憶體內部資料庫，請呼叫 UseInMemoryDatabase(DbContextOptionsBuilder, String, InMemoryDatabaseRoot, Action<InMemoryDbContextOptionsBuilder>) 將共用 InMemoryDatabaseRoot 傳遞給資料庫的根目錄。
UseChangeTrackingProxies(DbContextOptionsBuilder, Boolean, Boolean)	開啟變更追蹤 Proxy 的建立。
UseLazyLoadingProxies(DbContextOptionsBuilder, Action<LazyLoadingProxiesOptionsBuilder>)	開啟延遲載入 Proxy 的建立。
UseLazyLoadingProxies(DbContextOptionsBuilder, Boolean)	開啟延遲載入 Proxy 的建立。
UseSqlite(DbContextOptionsBuilder, Action<SqliteDbContextOptionsBuilder>)	設定內容以連線到 SQLite 資料庫，但不一開始設定任何 DbConnection 或連接字串。
UseSqlite(DbContextOptionsBuilder, DbConnection, Action<SqliteDbContextOptionsBuilder>)	設定內容以連線到 SQLite 資料庫。
UseSqlite(DbContextOptionsBuilder, DbConnection, Boolean, Action<SqliteDbContextOptionsBuilder>)	設定內容以連線到 SQLite 資料庫。
UseSqlite(DbContextOptionsBuilder, String, Action<SqliteDbContextOptionsBuilder>)	設定內容以連線到 SQLite 資料庫。
UseSqlServer(DbContextOptionsBuilder, Action<SqlServerDbContextOptionsBuilder>)	設定內容以連線到 Microsoft SQL Server 資料庫，但不一開始設定任何 DbConnection 或連接字串。
UseSqlServer(DbContextOptionsBuilder, DbConnection, Action<SqlServerDbContextOptionsBuilder>)	設定內容以連線到 Microsoft SQL Server 資料庫。
UseSqlServer(DbContextOptionsBuilder, DbConnection, Boolean, Action<SqlServerDbContextOptionsBuilder>)	設定內容以連線到 Microsoft SQL Server 資料庫。
UseSqlServer(DbContextOptionsBuilder, String, Action<SqlServerDbContextOptionsBuilder>)	設定內容以連線到 Microsoft SQL Server 資料庫。