語言

RelationalOptionsExtension 類別

定義

代表由關聯式資料庫提供者管理的選項。 這些選項使用 DbContextOptionsBuilder。

public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
[System.Runtime.CompilerServices.Nullable(0)]
public abstract class RelationalOptionsExtension : Microsoft.EntityFrameworkCore.Infrastructure.IDbContextOptionsExtension
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension
[<System.Runtime.CompilerServices.Nullable(0)>]
type RelationalOptionsExtension = class
    interface IDbContextOptionsExtension
Public MustInherit Class RelationalOptionsExtension
Implements IDbContextOptionsExtension
繼承
RelationalOptionsExtension
屬性
實作

備註

此類別的實例設計為不可變。 要更改選項,請撥打其中一位「與...」取得新實例且選項變更的方法。

更多資訊與範例請參見 資料庫提供者與擴充功能的實作 。

建構函式

名稱 Description
RelationalOptionsExtension()

建立一組新的選項,所有選項都設為預設值。

RelationalOptionsExtension(RelationalOptionsExtension)

在實作該 Clone() 方法時,由派生類別建構子呼叫。

屬性

名稱 Description
CommandTimeout

指令逾時,或者 null 如果沒有設定,則是。

Connection

DbConnection null或是如果使用連接字串代替完整的連接物件。

ConnectionString

使用 連接字串,或null是如果使用 a DbConnection 代替 連接字串。

ExecutionStrategyFactory

一個工廠用來建立預設 IExecutionStrategy,或者 null 如果沒有設定過。

Info

關於擴充功能的資訊/元資料。

IsConnectionOwned

true 如果該情 Connection 境擁有,並應適當處理。

LogFragment

建立一個用於日誌的訊息片段,通常包含任何已設定的有用非預設選項資訊。

MaxBatchSize

在設定期間或null未設定指令時,最多包含在指令中包含SaveChanges()的語句數量。

MigrationsAssembly

包含遷移的集合名稱,或 null 若未設定遷移遷移,則為該集合名稱。

MigrationsAssemblyObject

包含遷移的組裝,或 null 若未設定遷移,則為該組合。

MigrationsHistoryTableName

遷移歷史資料表的表格名稱,或 null 是尚未設定資料表。

MigrationsHistoryTableSchema

遷移歷史表的結構模式,或者 null 如果沒有設定,也該用來設定。

MinBatchSize

在設定多語句指令時,或未設定時,傳送到資料庫SaveChanges()null所需的最少語句數。

ParameterizedCollectionMode

參數化集合的轉換模式。

ParameterizedCollectionTranslationMode

參數化集合的轉換模式。

QuerySplittingBehavior

在查詢中載入相關集合時使用的 。QuerySplittingBehavior

UseRelationalNulls

表示在比較空值時是否應使用關聯式資料庫語意。 預設情況下,Entity Framework 會使用 C# 語意來處理 null 值,並產生 SQL 以補償資料庫處理 null 的方式差異。

方法

名稱 Description
ApplyServices(IServiceCollection)

新增讓所選選項運作所需的服務。 當沒有外部 IServiceProvider 服務且 EF 內部維護自己的服務提供者時,會使用此方法。 這讓資料庫提供者(及其他擴充功能)在 EF 建立服務提供者時能註冊其所需服務。

Clone()

在衍生類別中覆寫此方法,以確保所建立的克隆也屬於該類別。

Extract(IDbContextOptions)

尋找 RelationalOptionsExtension 已登記在指定選項上的現有玩家,若沒有註冊選項則棄牌。 這通常用於在已知使用關聯提供者時,找到某種關聯配置。

GetServiceProviderHashCode()

回傳一個由任何選項產生的雜湊碼,這些選項會產生 IServiceProvider 新的新值。 大多數擴充功能沒有這類選項,理應回傳為零。

Validate(IDbContextOptions)

這讓擴充功能有機會驗證擴充中所有選項的有效性。 大多數擴充功能沒有無效組合,因此這將是 no-op。 若選項無效,則應拋出例外。

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(Assembly)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithMigrationsAssembly(String)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithMigrationsHistoryTableName(String)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithMigrationsHistoryTableSchema(String)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithMinBatchSize(Nullable<Int32>)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithParameterizedCollectionTranslationMode(ParameterizedCollectionTranslationMode)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithUseParameterizedCollectionMode(ParameterTranslationMode)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithUseQuerySplittingBehavior(QuerySplittingBehavior)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

WithUseRelationalNulls(Boolean)

建立一個新實例,所有選項與此實例相同,但所給選項有所改變。 直接稱呼此方法並不常見。 請改用 DbContextOptionsBuilder。

適用於