語言

SqlServerDbContextOptionsBuilder 類別

定義

允許在 上執行 DbContextOptionsSQL Server 專屬設定。

public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.Infrastructure.Internal.SqlServerOptionsExtension>
[System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1 })]
public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.SqlEngineDbContextOptionsBuilderBase<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>
public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal.SqlServerOptionsExtension>
[System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1, 1 })]
public class SqlServerDbContextOptionsBuilder : Microsoft.EntityFrameworkCore.Infrastructure.RelationalDbContextOptionsBuilder<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal.SqlServerOptionsExtension>
type SqlServerDbContextOptionsBuilder = class
    inherit RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder, SqlServerOptionsExtension>
[<System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1 })>]
type SqlServerDbContextOptionsBuilder = class
    inherit SqlEngineDbContextOptionsBuilderBase<SqlServerDbContextOptionsBuilder>
[<System.Runtime.CompilerServices.Nullable(new System.Byte[] { 0, 1, 1 })>]
type SqlServerDbContextOptionsBuilder = class
    inherit RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder, SqlServerOptionsExtension>
Public Class SqlServerDbContextOptionsBuilder
Inherits RelationalDbContextOptionsBuilder(Of SqlServerDbContextOptionsBuilder, SqlServerOptionsExtension)
Public Class SqlServerDbContextOptionsBuilder
Inherits SqlEngineDbContextOptionsBuilderBase(Of SqlServerDbContextOptionsBuilder)
繼承
RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.Infrastructure.Internal.SqlServerOptionsExtension>
SqlServerDbContextOptionsBuilder
繼承
繼承
RelationalDbContextOptionsBuilder<SqlServerDbContextOptionsBuilder,Microsoft.EntityFrameworkCore.SqlServer.Infrastructure.Internal.SqlServerOptionsExtension>
SqlServerDbContextOptionsBuilder
屬性

備註

這個類別的實例是從呼叫回傳的 SqlServerDbContextOptionsExtensions.UseSqlServer ,並非設計成直接在你的應用程式程式碼中建構。

建構函式

名稱 Description
SqlServerDbContextOptionsBuilder(DbContextOptionsBuilder)

初始化 SqlServerDbContextOptionsBuilder 類別的新執行個體。

屬性

名稱 Description
OptionsBuilder

獲得核心選項建構器。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)

方法

名稱 Description
CloneExtension()

在這個建構器中複製了這個配置。

CommandTimeout(Nullable<Int32>)

設定等待時間(以秒為單位),然後終止執行指令並產生錯誤。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
EnableRetryOnFailure()

設定上下文以使用預設的重試 IExecutionStrategy。

EnableRetryOnFailure(ICollection<Int32>)

設定上下文以使用預設的重試 IExecutionStrategy。

EnableRetryOnFailure(Int32, TimeSpan, ICollection<Int32>)

設定上下文以使用預設的重試 IExecutionStrategy。

此策略專為 SQL Server(包括 SQL Azure)量身打造。 它預先設定了可用於暫態錯誤的錯誤號碼,這些錯誤可重試,但也可以提供額外的錯誤號碼。

EnableRetryOnFailure(Int32, TimeSpan, IEnumerable<Int32>)

設定上下文以使用預設的重試 IExecutionStrategy。

EnableRetryOnFailure(Int32)

設定上下文以使用預設的重試 IExecutionStrategy。

ExecutionStrategy(Func<ExecutionStrategyDependencies,IExecutionStrategy>)

配置上下文以使用提供的 IExecutionStrategy。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
MaxBatchSize(Int32)

設定在 期間傳送到資料庫 SaveChanges()的指令中,最多可包含的語句數量。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
MigrationsAssembly(Assembly)

配置此情境下維護遷移的組裝。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
MigrationsAssembly(String)

配置此情境下維護遷移的組裝。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
MigrationsHistoryTable(String, String)

配置用於記錄已應用於資料庫的遷移資料表名稱。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
MinBatchSize(Int32)

配置在 期間傳送至資料庫 SaveChanges()的多語句指令所需的最少語句數。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
TranslateParameterizedCollectionsToConstants()
已淘汰.

配置上下文以將參數化集合轉換為內聯常數。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
TranslateParameterizedCollectionsToParameters()
已淘汰.

設定上下文以將參數化集合轉換成單一陣列類參數。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
UseAzureSqlDefaults(Boolean)
已淘汰.

設定上下文以使用針對 Azure SQL 優化的預設值,包括錯誤重試。

UseCompatibilityLevel(Int32)

設定 EF Core 與資料庫互動時所採用的 SQL Server 相容性等級。 這讓 EF Core 能夠與較舊(或較新)版本的 SQL Server 相容。 預設為 160 (SQL Server 2022)。

UseQuerySplittingBehavior(QuerySplittingBehavior)

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

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
UseRelationalNulls(Boolean)

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

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)
UseRowNumberForPaging()

查詢時用 ROW_NUMBER() 代替 OFFSET/FETCH。 此方法向下相容於 SQL Server 2005。

UseRowNumberForPaging(Boolean)
已淘汰.

查詢時用 ROW_NUMBER() 代替 OFFSET/FETCH。 此方法向下相容於 SQL Server 2005。

WithOption(Func<TExtension,TExtension>)

透過複製儲存設定的擴充功能來設定一個選項。 這確保建商不會修改其他地方已在使用的選項。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)

明確介面實作

名稱 Description
IRelationalDbContextOptionsBuilderInfrastructure.OptionsBuilder

獲得核心選項建構器。

(繼承來源 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)

擴充方法

名稱 Description
UseNetTopologySuite(SqlServerDbContextOptionsBuilder)

使用 NetTopologySuite 來存取 SQL Server 的空間資料。

適用於