SqlServerDbContextOptionsExtensions.UseSqlServer 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
重载
UseSqlServer(DbContextOptionsBuilder, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库，但最初未设置任何DbConnection或连接字符串。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default);public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> sqlServerOptionsAction = default);static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<Extension()>
Public Function UseSqlServer (optionsBuilder As DbContextOptionsBuilder, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder参数
- optionsBuilder
- DbContextOptionsBuilder
用于配置上下文的生成器。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
必须先设置连接或连接字符串，然后DbContext才能使用连接数据库。 使用 SetDbConnection(DatabaseFacade, DbConnection, Boolean). 设置连接。 使用 SetConnectionString(DatabaseFacade, String). 设置连接字符串。
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer(DbContextOptionsBuilder, DbConnection, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, System.Data.Common.DbConnection connection, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> sqlServerOptionsAction = default);public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, System.Data.Common.DbConnection connection, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default);static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder * System.Data.Common.DbConnection * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<Extension()>
Public Function UseSqlServer (optionsBuilder As DbContextOptionsBuilder, connection As DbConnection, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder参数
- optionsBuilder
- DbContextOptionsBuilder
用于配置上下文的生成器。
- connection
- DbConnection
用于连接到数据库的现有数据库 DbConnection 。 如果连接处于打开状态，EF 将不会打开或关闭连接。 如果连接处于关闭状态，EF 将根据需要打开并关闭连接。 调用方拥有连接，并负责其处置。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer(DbContextOptionsBuilder, String, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, string connectionString, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> sqlServerOptionsAction = default);public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, string? connectionString, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default);public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, string connectionString, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default);static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder * string * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<Extension()>
Public Function UseSqlServer (optionsBuilder As DbContextOptionsBuilder, connectionString As String, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder参数
- optionsBuilder
- DbContextOptionsBuilder
用于配置上下文的生成器。
- connectionString
- String
要连接到的数据库连接字符串。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer(DbContextOptionsBuilder, DbConnection, Boolean, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder UseSqlServer(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder optionsBuilder, System.Data.Common.DbConnection connection, bool contextOwnsConnection, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default);static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder * System.Data.Common.DbConnection * bool * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<Extension()>
Public Function UseSqlServer (optionsBuilder As DbContextOptionsBuilder, connection As DbConnection, contextOwnsConnection As Boolean, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder参数
- optionsBuilder
- DbContextOptionsBuilder
用于配置上下文的生成器。
- connection
- DbConnection
用于连接到数据库的现有数据库 DbConnection 。 如果连接处于打开状态，EF 将不会打开或关闭连接。 如果连接处于关闭状态，EF 将根据需要打开并关闭连接。
- contextOwnsConnection
- Boolean
如果 true，则 EF 将获取连接的所有权，并采用与释放 EF 创建的连接的方式相同。 如果 false，则调用方仍拥有连接，并负责其处置。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, String, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, string connectionString, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, string? connectionString, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, string connectionString, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> * string * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)<Extension()>
Public Function UseSqlServer(Of TContext As DbContext) (optionsBuilder As DbContextOptionsBuilder(Of TContext), connectionString As String, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder(Of TContext)类型参数
- TContext
要配置的上下文的类型。
参数
- optionsBuilder
- DbContextOptionsBuilder<TContext>
用于配置上下文的生成器。
- connectionString
- String
要连接到的数据库连接字符串。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库，但最初未设置任何DbConnection或连接字符串。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)<Extension()>
Public Function UseSqlServer(Of TContext As DbContext) (optionsBuilder As DbContextOptionsBuilder(Of TContext), Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder(Of TContext)类型参数
- TContext
参数
- optionsBuilder
- DbContextOptionsBuilder<TContext>
用于配置上下文的生成器。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
必须先设置连接或连接字符串，然后DbContext才能使用连接数据库。 使用 SetDbConnection(DatabaseFacade, DbConnection, Boolean). 设置连接。 使用 SetConnectionString(DatabaseFacade, String). 设置连接字符串。
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, DbConnection, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, System.Data.Common.DbConnection connection, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, System.Data.Common.DbConnection connection, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> * System.Data.Common.DbConnection * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)<Extension()>
Public Function UseSqlServer(Of TContext As DbContext) (optionsBuilder As DbContextOptionsBuilder(Of TContext), connection As DbConnection, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder(Of TContext)类型参数
- TContext
要配置的上下文的类型。
参数
- optionsBuilder
- DbContextOptionsBuilder<TContext>
用于配置上下文的生成器。
- connection
- DbConnection
用于连接到数据库的现有数据库 DbConnection 。 如果连接处于打开状态，EF 将不会打开或关闭连接。 如果连接处于关闭状态，EF 将根据需要打开并关闭连接。 调用方拥有连接，并负责其处置。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server Synapse 特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
适用于
UseSqlServer<TContext>(DbContextOptionsBuilder<TContext>, DbConnection, Boolean, Action<SqlServerDbContextOptionsBuilder>)
配置上下文以连接到SQL Server数据库。
public static Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> UseSqlServer<TContext>(this Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<TContext> optionsBuilder, System.Data.Common.DbConnection connection, bool contextOwnsConnection, Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder>? sqlServerOptionsAction = default) where TContext : Microsoft.EntityFrameworkCore.DbContext;static member UseSqlServer : Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> * System.Data.Common.DbConnection * bool * Action<Microsoft.EntityFrameworkCore.Infrastructure.SqlServerDbContextOptionsBuilder> -> Microsoft.EntityFrameworkCore.DbContextOptionsBuilder<'Context (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)> (requires 'Context :> Microsoft.EntityFrameworkCore.DbContext)<Extension()>
Public Function UseSqlServer(Of TContext As DbContext) (optionsBuilder As DbContextOptionsBuilder(Of TContext), connection As DbConnection, contextOwnsConnection As Boolean, Optional sqlServerOptionsAction As Action(Of SqlServerDbContextOptionsBuilder) = Nothing) As DbContextOptionsBuilder(Of TContext)类型参数
- TContext
要配置的上下文的类型。
参数
- optionsBuilder
- DbContextOptionsBuilder<TContext>
用于配置上下文的生成器。
- connection
- DbConnection
用于连接到数据库的现有数据库 DbConnection 。 如果连接处于打开状态，EF 将不会打开或关闭连接。 如果连接处于关闭状态，EF 将根据需要打开并关闭连接。
- contextOwnsConnection
- Boolean
如果 true，则 EF 将获取连接的所有权，并采用与释放 EF 创建的连接的方式相同。 如果 false，则调用方仍拥有连接，并负责其处置。
- sqlServerOptionsAction
- Action<SqlServerDbContextOptionsBuilder>
用于允许其他SQL Server Synapse 特定配置的可选操作。
返回
选项生成器，以便可以链接进一步的配置。
注解
有关详细信息和示例，请参阅使用 DBContextOptions 和访问 SQL Server、Azure SQL、Azure Synapse 数据库和 EF Core。
