RelationalDatabaseFacadeExtensions 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
傳回之 Database 的 DatabaseFacade 擴充方法，只能與關係資料庫提供者搭配使用。
public static class RelationalDatabaseFacadeExtensionstype RelationalDatabaseFacadeExtensions = classPublic Module RelationalDatabaseFacadeExtensions- 繼承
-
RelationalDatabaseFacadeExtensions
方法
| BeginTransaction(DatabaseFacade, IsolationLevel) |
使用指定的 IsolationLevel 啟動新的交易。 |
| BeginTransactionAsync(DatabaseFacade, IsolationLevel, CancellationToken) |
以非同步方式啟動具有指定 IsolationLevel 的新交易。 |
| CloseConnection(DatabaseFacade) |
關閉基礎 DbConnection 。 |
| CloseConnectionAsync(DatabaseFacade) |
關閉基礎 DbConnection 。 |
| ExecuteSql(DatabaseFacade, FormattableString) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlAsync(DatabaseFacade, FormattableString, CancellationToken) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlCommand(DatabaseFacade, FormattableString) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。
如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommand(DatabaseFacade, RawSqlString, IEnumerable<Object>) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。 如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter。 您也可以考慮使用 ExecuteSqlInterpolated 來使用插補字串語法來建立參數。 |
| ExecuteSqlCommand(DatabaseFacade, RawSqlString, Object[]) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。
如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommand(DatabaseFacade, String, Object[]) |
傳回之 Database 的 DatabaseFacade 擴充方法，只能與關係資料庫提供者搭配使用。 |
| ExecuteSqlCommandAsync(DatabaseFacade, FormattableString, CancellationToken) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。
如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, CancellationToken) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。
如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, IEnumerable<Object>, CancellationToken) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。 如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter。 您也可以考慮使用 ExecuteSqlInterpolated 來使用插補字串語法來建立參數。 |
| ExecuteSqlCommandAsync(DatabaseFacade, RawSqlString, Object[]) |
已淘汰.
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 請注意，這個方法不會啟動交易。 若要搭配交易使用這個方法，請先呼叫 BeginTransaction(DatabaseFacade, IsolationLevel) 或 UseTransaction(DatabaseFacade, DbTransaction) 。 請注意，此方法不會使用目前的 ExecutionStrategy ，因為 SQL 可能不是等冪，而且不會在交易中執行。 可以明確使用 ExecutionStrategy，如果 SQL 不是等冪性，請務必也使用交易。
如同接受 SQL 的任何 API，請務必將任何使用者輸入參數化，以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含參數預留位置，然後提供參數值作為其他引數。 您提供的任何參數值都會自動轉換成 DbParameter - |
| ExecuteSqlCommandAsync(DatabaseFacade, String, CancellationToken, Object[]) |
傳回之 Database 的 DatabaseFacade 擴充方法，只能與關係資料庫提供者搭配使用。 |
| ExecuteSqlInterpolated(DatabaseFacade, FormattableString) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlInterpolatedAsync(DatabaseFacade, FormattableString, CancellationToken) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlRaw(DatabaseFacade, String, IEnumerable<Object>) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlRaw(DatabaseFacade, String, Object[]) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlRawAsync(DatabaseFacade, String, CancellationToken) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlRawAsync(DatabaseFacade, String, IEnumerable<Object>, CancellationToken) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| ExecuteSqlRawAsync(DatabaseFacade, String, Object[]) |
針對資料庫執行指定的 SQL，並傳回受影響的資料列數目。 |
| GenerateCreateScript(DatabaseFacade) |
產生腳本，以建立目前模型的所有資料表。 |
| GetAppliedMigrations(DatabaseFacade) |
取得已套用至目標資料庫的所有移轉。 |
| GetAppliedMigrationsAsync(DatabaseFacade, CancellationToken) |
以非同步方式取得已套用至目標資料庫的所有移轉。 |
| GetCommandTimeout(DatabaseFacade) |
傳回以秒為單位的逾時 (，) 針對以這個 DbContext 執行的命令設定。 |
| GetConnectionString(DatabaseFacade) |
取得為此 DbContext 設定的基礎連接字串。 |
| GetDbConnection(DatabaseFacade) |
取得這個 DbContext 的基礎 ADO.NET DbConnection 。 |
| GetMigrations(DatabaseFacade) |
取得已設定移轉元件中定義的所有移轉。 |
| GetPendingMigrations(DatabaseFacade) |
取得元件中定義但尚未套用至目標資料庫的所有移轉。 |
| GetPendingMigrationsAsync(DatabaseFacade, CancellationToken) |
以非同步方式取得元件中定義但尚未套用至目標資料庫的所有移轉。 |
| HasPendingModelChanges(DatabaseFacade) |
|
| IsRelational(DatabaseFacade) |
如果目前使用中的資料庫提供者是關係資料庫，則傳 |
| Migrate(DatabaseFacade) |
將內容的任何擱置移轉套用至資料庫。 如果資料庫不存在，將會建立資料庫。 |
| MigrateAsync(DatabaseFacade, CancellationToken) |
以非同步方式將內容的任何擱置移轉套用至資料庫。 如果資料庫不存在，將會建立資料庫。 |
| OpenConnection(DatabaseFacade) |
開啟基礎 DbConnection 。 |
| OpenConnectionAsync(DatabaseFacade, CancellationToken) |
開啟基礎 DbConnection 。 |
| SetCommandTimeout(DatabaseFacade, Nullable<Int32>) |
設定以秒為單位的逾時 (，) 用於以這個 DbContext 執行的命令。 |
| SetCommandTimeout(DatabaseFacade, TimeSpan) |
設定用於以這個 DbContext 執行之命令的逾時。 |
| SetConnectionString(DatabaseFacade, String) |
設定為此 DbContext 設定的基礎連接字串。 |
| SetDbConnection(DatabaseFacade, DbConnection, Boolean) |
設定這個 DbContext 的基礎 ADO.NET DbConnection 。 |
| SetDbConnection(DatabaseFacade, DbConnection) |
設定這個 DbContext 的基礎 ADO.NET DbConnection 。 |
| SqlQuery<TResult>(DatabaseFacade, FormattableString) |
根據原始 SQL 查詢建立 LINQ 查詢，此查詢會傳回資料庫提供者原生支援的純量類型結果集。 |
| SqlQueryRaw<TResult>(DatabaseFacade, String, Object[]) |
根據原始 SQL 查詢建立 LINQ 查詢，此查詢會傳回資料庫提供者原生支援的純量類型結果集。 |
| UseTransaction(DatabaseFacade, DbTransaction, Guid) |
DbTransaction設定 上 DbContext 資料庫作業要使用的 。 |
| UseTransaction(DatabaseFacade, DbTransaction) |
DbTransaction設定 上 DbContext 資料庫作業要使用的 。 |
| UseTransactionAsync(DatabaseFacade, DbTransaction, CancellationToken) |
DbTransaction設定 上 DbContext 資料庫作業要使用的 。 |
| UseTransactionAsync(DatabaseFacade, DbTransaction, Guid, CancellationToken) |
DbTransaction設定 上 DbContext 資料庫作業要使用的 。 |
