RelationalOptionsExtension 類別

定義

命名空間:

Microsoft.EntityFrameworkCore.Infrastructure

組件:

Microsoft.EntityFrameworkCore.Relational.dll

套件:

Microsoft.EntityFrameworkCore.Relational v8.0.0

表示關係資料庫提供者所管理的選項。 這些選項是使用 DbContextOptionsBuilder 來設定。

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension

type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension

Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension

繼承

Object

RelationalOptionsExtension

實作

IDbContextOptionsExtension

備註

這個類別的實例設計為不可變。 若要變更選項，請呼叫其中一個 'With...'取得選項已變更的新實例的方法。

如需詳細資訊和範例，請參閱 資料庫提供者和延伸模組的實作 。

建構函式

RelationalOptionsExtension()	建立一組新的選項，其中所有選項都設定為預設值。
RelationalOptionsExtension(RelationalOptionsExtension)	實作 方法時，由衍生類別建構函式呼叫 Clone() 。

屬性

CommandTimeout	命令逾時，如果尚未設定，則 null 為 。
Connection	如果使用 DbConnection 連接字串，則為 ， null 而不是完整連線物件。
ConnectionString	連接字串，如果使用 DbConnection ，而不是 null 使用 連接字串。
ExecutionStrategyFactory	用於建立預設 IExecutionStrategy 的處理站，如果尚未設定，則 null 為 。
Info	延伸模組的相關資訊/中繼資料。
IsConnectionOwned	true Connection如果 是由內容所擁有，則應該適當處置。
MaxBatchSize	在或未設定任何語句時 SaveChanges()null ，傳送至資料庫的命令中將包含的語句數目上限。
MigrationsAssembly	包含移轉的元件名稱，如果沒有設定，則 null 為 。
MigrationsHistoryTableName	要用於移轉歷程記錄資料表的資料表名稱，如果沒有設定，則 null 為 。
MigrationsHistoryTableSchema	要用於移轉歷程記錄資料表的架構，如果沒有設定，則 null 為 。
MinBatchSize	在 期間 null 或未設定任何語句時 SaveChanges() ，傳送至資料庫之多語句命令所需的語句數目下限。
QuerySplittingBehavior	在 QuerySplittingBehavior 查詢中載入相關集合時要使用的 。
UseRelationalNulls	指出比較 Null 值時，是否要使用關係資料庫語意。 根據預設，Entity Framework 會針對 Null 值使用 C# 語意，並產生 SQL 來補償資料庫如何處理 Null 的差異。

方法

ApplyServices(IServiceCollection)	新增讓選取的選項運作所需的服務。 當沒有外部且 EF 在內部 IServiceProvider 維護自己的服務提供者時，就會使用此功能。 這可讓資料庫提供者 (和其他延伸模組) 在 EF 建立服務提供者時註冊其必要服務。
Clone()	覆寫衍生類別中的這個方法，以確保建立的任何複製專案也是該類別的。
Extract(IDbContextOptions)	在指定的選項上尋找已註冊的現有 RelationalOptionsExtension ，如果尚未註冊，則會擲回 。 這通常用來在已知正在使用關係提供者時尋找一些關聯式組態。
Validate(IDbContextOptions)	讓延伸模組有機會驗證延伸模組中的所有選項是否有效。 大部分的延伸模組沒有不正確組合，因此這會是無作業。 如果選項無效，則應該擲回例外狀況。
WithCommandTimeout(Nullable<Int32>)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithConnection(DbConnection, Boolean)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithConnection(DbConnection)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithConnectionString(String)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithDefaultWarningConfiguration(CoreOptionsExtension)	新增關聯式事件的預設值 WarningBehavior 。
WithExecutionStrategyFactory(Func<ExecutionStrategyDependencies,IExecutionStrategy>)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithMaxBatchSize(Nullable<Int32>)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithMigrationsAssembly(String)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithMigrationsHistoryTableName(String)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithMigrationsHistoryTableSchema(String)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithMinBatchSize(Nullable<Int32>)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithUseQuerySplittingBehavior(QuerySplittingBehavior)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。
WithUseRelationalNulls(Boolean)	建立與這個實例相同的所有選項的新實例，但指定選項已變更。 直接呼叫這個方法並不尋常。 請改用 DbContextOptionsBuilder 。