语言

SqlServerDbContextOptionsBuilder 类

定义

允许对SQL Server执行特定配置DbContextOptions。

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 返回的,它不设计为直接在应用程序代码中构造。

构造函数

名称 说明
SqlServerDbContextOptionsBuilder(DbContextOptionsBuilder)

初始化 SqlServerDbContextOptionsBuilder 类的新实例。

属性

名称 说明
OptionsBuilder

获取核心选项生成器。

(继承自 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)

方法

名称 说明
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)

配置上下文以在比较 null 值时使用关系数据库语义。 默认情况下,Entity Framework 将为 null 值使用 C# 语义,并生成 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>)

显式接口实现

名称 说明
IRelationalDbContextOptionsBuilderInfrastructure.OptionsBuilder

获取核心选项生成器。

(继承自 RelationalDbContextOptionsBuilder<TBuilder,TExtension>)

扩展方法

名称 说明
UseNetTopologySuite(SqlServerDbContextOptionsBuilder)

使用 NetTopologySuite 访问SQL Server空间数据。

适用于