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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
適用於
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，以及使用 EF Core 存取 SQL Server、Azure SQL、Azure Synapse 資料庫。
