SqlBulkCopy.WriteToServerAsync 方法

  • 參考

定義

命名空間:
System.Data.SqlClient
組件:
System.Data.SqlClient.dll
組件:
System.Data.dll
套件:
System.Data.SqlClient v4.8.5

WriteToServer 的非同步版本，它會將所有資料列從資料來源複製到 SqlBulkCopy 物件的 DestinationTableName 屬性所指定的目的資料表。

多載

WriteToServerAsync(IDataReader, CancellationToken)

WriteToServer(IDataReader) 的非同步版本，其會將提供的 IDataReader 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。
WriteToServerAsync(DbDataReader)

WriteToServer(DbDataReader) 的非同步版本，它會將所有資料列從提供的 DbDataReader 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。
WriteToServerAsync(DataRow[])

WriteToServer(DataRow[]) 的非同步版本，它會將所有資料列從提供的 DataRow 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。
WriteToServerAsync(DataTable)

WriteToServer(DataTable) 的非同步版本，其會將提供的 DataTable 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。
WriteToServerAsync(IDataReader)

WriteToServer(IDataReader) 的非同步版本，其會將提供的 IDataReader 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。
WriteToServerAsync(DbDataReader, CancellationToken)

WriteToServer(DbDataReader) 的非同步版本，它會將所有資料列從提供的 DbDataReader 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。
WriteToServerAsync(DataRow[], CancellationToken)

WriteToServer(DataRow[]) 的非同步版本，它會將所有資料列從提供的 DataRow 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。
WriteToServerAsync(DataTable, DataRowState)

WriteToServer(DataTable, DataRowState) 的非同步版本，它只會將提供的 DataTable 之內符合提供的資料列狀態之資料列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。
WriteToServerAsync(DataTable, CancellationToken)

WriteToServer(DataTable) 的非同步版本，其會將提供的 DataTable 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。
WriteToServerAsync(DataTable, DataRowState, CancellationToken)

WriteToServer(DataTable, DataRowState) 的非同步版本，它只會將提供的 DataTable 之內符合提供的資料列狀態之資料列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

備註

如果停用多個作用中結果集 (MARS) ， WriteToServer 請讓連線忙碌中。 如果已啟用 MARS，您可以與相同連線中的其他命令交錯呼叫 WriteToServer 。

當一個失敗時復原的資料列數目取決於下列幾件事：

當將資料傳送至伺服器時發生錯誤時，將會回復) 所 BatchSize 指定的目前批次 (。 如果未 UseInternalTransaction 指定 ，而且您擁有自己的交易，則會回復整個交易， (其中包含所有先前的批次以及) 。

用來 SqlRowsCopied 知道有多少個數據列複製到伺服器。

WriteToServerAsync(IDataReader, CancellationToken)

WriteToServer(IDataReader) 的非同步版本，其會將提供的 IDataReader 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.IDataReader reader, System.Threading.CancellationToken cancellationToken);
member this.WriteToServerAsync : System.Data.IDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As Task

參數

reader
IDataReader

IDataReader，其資料列會複製到目的資料表。

cancellationToken
CancellationToken

取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(IDataReader)。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。

在 WriteToServerAsync(IDataReader) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

IDataReader在已完成的Task傳回之前已關閉。

IDataReader的關聯連接在已完成的Task傳回之前已關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(IDataReader) 擲回的例外狀況。

適用於

WriteToServerAsync(DbDataReader)

WriteToServer(DbDataReader) 的非同步版本，它會將所有資料列從提供的 DbDataReader 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.Common.DbDataReader reader);
member this.WriteToServerAsync : System.Data.Common.DbDataReader -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (reader As DbDataReader) As Task

參數

reader
DbDataReader

DbDataReader，其資料列會複製到目的資料表。

傳回

Task

表示非同步作業的工作。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DbDataReader) 擲回的例外狀況。

適用於

WriteToServerAsync(DataRow[])

WriteToServer(DataRow[]) 的非同步版本，它會將所有資料列從提供的 DataRow 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows);
member this.WriteToServerAsync : System.Data.DataRow[] -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (rows As DataRow()) As Task

參數

rows
DataRow[]

要複製至目的資料表之 DataRow 物件的陣列。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataRow[])。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[])。

在 WriteToServerAsync(DataRow[]) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DataRow[]) 擲回的例外狀況。

適用於

WriteToServerAsync(DataTable)

WriteToServer(DataTable) 的非同步版本，其會將提供的 DataTable 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table);
member this.WriteToServerAsync : System.Data.DataTable -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (table As DataTable) As Task

參數

table
DataTable

DataTable，其資料列會複製到目的資料表。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable)。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable)。

在 WriteToServerAsync(DataTable) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DataTable) 擲回的例外狀況。

適用於

WriteToServerAsync(IDataReader)

WriteToServer(IDataReader) 的非同步版本，其會將提供的 IDataReader 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::IDataReader ^ reader);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.IDataReader reader);
member this.WriteToServerAsync : System.Data.IDataReader -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (reader As IDataReader) As Task

參數

reader
IDataReader

IDataReader，其資料列會複製到目的資料表。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(IDataReader)。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。

在 WriteToServerAsync(IDataReader) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

IDataReader在已完成的Task傳回之前已關閉。

IDataReader的關聯連接在已完成的Task傳回之前已關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(IDataReader) 擲回的例外狀況。

適用於

WriteToServerAsync(DbDataReader, CancellationToken)

WriteToServer(DbDataReader) 的非同步版本，它會將所有資料列從提供的 DbDataReader 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::Common::DbDataReader ^ reader, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.Common.DbDataReader reader, System.Threading.CancellationToken cancellationToken);
member this.WriteToServerAsync : System.Data.Common.DbDataReader * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task

參數

reader
DbDataReader

DbDataReader，其資料列會複製到目的資料表。

cancellationToken
CancellationToken

取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DbDataReader)。

傳回

Task

傳回 Task。

例外狀況

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DbDataReader) 擲回的例外狀況。

適用於

WriteToServerAsync(DataRow[], CancellationToken)

WriteToServer(DataRow[]) 的非同步版本，它會將所有資料列從提供的 DataRow 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(cli::array <System::Data::DataRow ^> ^ rows, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataRow[] rows, System.Threading.CancellationToken cancellationToken);
member this.WriteToServerAsync : System.Data.DataRow[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task

參數

rows
DataRow[]

要複製至目的資料表之 DataRow 物件的陣列。

cancellationToken
CancellationToken

取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataRow[])。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[])。

在 WriteToServerAsync(DataRow[]) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DataRow[]) 擲回的例外狀況。

適用於

WriteToServerAsync(DataTable, DataRowState)

WriteToServer(DataTable, DataRowState) 的非同步版本，它只會將提供的 DataTable 之內符合提供的資料列狀態之資料列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Data.DataRowState rowState);
member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task

參數

table
DataTable

DataTable，其資料列會複製到目的資料表。

rowState
DataRowState

DataRowState 列舉中的值。 只將符合資料列狀態的資料列複製到目的端。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable, DataRowState)。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState)。

在 WriteToServerAsync(DataTable, DataRowState) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DataTable, DataRowState) 擲回的例外狀況。

適用於

WriteToServerAsync(DataTable, CancellationToken)

WriteToServer(DataTable) 的非同步版本，其會將提供的 DataTable 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Threading.CancellationToken cancellationToken);
member this.WriteToServerAsync : System.Data.DataTable * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task

參數

table
DataTable

DataTable，其資料列會複製到目的資料表。

cancellationToken
CancellationToken

取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable)。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable)。

在 WriteToServerAsync(DataTable) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

OperationCanceledException

取消權杖已取消。 此例外狀況會儲存在傳回的工作中。

備註

如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException ，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DataTable) 擲回的例外狀況。

適用於

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

WriteToServer(DataTable, DataRowState) 的非同步版本，它只會將提供的 DataTable 之內符合提供的資料列狀態之資料列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。

取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。

public:
 System::Threading::Tasks::Task ^ WriteToServerAsync(System::Data::DataTable ^ table, System::Data::DataRowState rowState, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task WriteToServerAsync (System.Data.DataTable table, System.Data.DataRowState rowState, System.Threading.CancellationToken cancellationToken);
member this.WriteToServerAsync : System.Data.DataTable * System.Data.DataRowState * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As Task

參數

table
DataTable

DataTable，其資料列會複製到目的資料表。

rowState
DataRowState

DataRowState 列舉中的值。 只將符合資料列狀態的資料列複製到目的端。

cancellationToken
CancellationToken

取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。

傳回

Task

表示非同步作業的工作。

例外狀況

InvalidOperationException

在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable, DataRowState)。

在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState)。

在 WriteToServerAsync(DataTable, DataRowState) 執行期間，連線中斷或關閉。

在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。

在工作物件中傳回，發生連接集區逾時。

在工作物件中傳回，SqlConnection物件在方法執行之前關閉。

Context Connection=true 指定於連接字串中。

SqlException

於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。

OperationCanceledException

解除標記已取消。 此例外狀況會儲存在傳回的工作中。

備註

如需 .NET Framework Data Provider for SQL Server 中非同步程式設計的詳細資訊，請參閱非同步程式設計。

這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用例外狀況，例如 ArgumentException 仍會同步擲回。 如需預存例外狀況，請參閱 擲回的 WriteToServer(DataTable, DataRowState) 例外狀況。

適用於