SqlBulkCopy.WriteToServerAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
WriteToServer 的非同步版本，它會將所有資料列從資料來源複製到 SqlBulkCopy 物件的 DestinationTableName 屬性所指定的目的資料表。
多載
備註
如果停用多個作用中結果集 (MARS) ， WriteToServer 連線就會忙碌中。 如果已啟用MARS，您可以與相同連線中的其他命令交錯呼叫 WriteToServer 。
當一個失敗時所復原的數據列數目取決於下列幾件事：
如果 UseInternalTransaction 已指定 ，則為 。
如果您有自己的交易。
BatchSize 的值。
將數據傳送至伺服器時發生錯誤時，將會回復) 指定的 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.TaskPublic Function WriteToServerAsync (reader As IDataReader, cancellationToken As CancellationToken) As Task參數
- reader
- IDataReader
IDataReader，其資料列會複製到目的資料表。
- cancellationToken
- CancellationToken
取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(IDataReader)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。
在 WriteToServerAsync(IDataReader) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
IDataReader在已完成的Task傳回之前已關閉。
IDataReader的關聯連接在已完成的Task傳回之前已關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
取消標記已取消。 此例外狀況會儲存在傳回的工作中。
備註
如需 .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.TaskPublic Function WriteToServerAsync (reader As DbDataReader) As Task參數
- reader
- DbDataReader
DbDataReader，其資料列會複製到目的資料表。
傳回
表示非同步作業的工作。
備註
如需 .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.TaskPublic Function WriteToServerAsync (rows As DataRow()) As Task參數
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataRow[])。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[])。
在 WriteToServerAsync(DataRow[]) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，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.TaskPublic Function WriteToServerAsync (table As DataTable) As Task參數
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable)。
在 WriteToServerAsync(DataTable) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，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.TaskPublic Function WriteToServerAsync (reader As IDataReader) As Task參數
- reader
- IDataReader
IDataReader，其資料列會複製到目的資料表。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(IDataReader)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。
在 WriteToServerAsync(IDataReader) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
IDataReader在已完成的Task傳回之前已關閉。
IDataReader的關聯連接在已完成的Task傳回之前已關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，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.TaskPublic Function WriteToServerAsync (reader As DbDataReader, cancellationToken As CancellationToken) As Task參數
- reader
- DbDataReader
DbDataReader，其資料列會複製到目的資料表。
- cancellationToken
- CancellationToken
取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DbDataReader)。
傳回
傳回 Task。
例外狀況
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 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.TaskPublic Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task參數
- cancellationToken
- CancellationToken
取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataRow[])。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataRow[]) 和 WriteToServer(DataRow[])。
在 WriteToServerAsync(DataRow[]) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
如需 .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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task參數
- rowState
- DataRowState
DataRowState 列舉中的值。 只將符合資料列狀態的資料列複製到目的端。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable, DataRowState)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState)。
在 WriteToServerAsync(DataTable, DataRowState) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，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.TaskPublic Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task參數
- cancellationToken
- CancellationToken
取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable) 和 WriteToServer(DataTable)。
在 WriteToServerAsync(DataTable) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
如需 .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.TaskPublic Function WriteToServerAsync (table As DataTable, rowState As DataRowState, cancellationToken As CancellationToken) As Task參數
- rowState
- DataRowState
DataRowState 列舉中的值。 只將符合資料列狀態的資料列複製到目的端。
- cancellationToken
- CancellationToken
取消指令。 這個參數中的 None 值會使這個方法相當於 WriteToServerAsync(DataTable)。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(DataTable, DataRowState)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(DataTable, DataRowState) 和 WriteToServer(DataTable, DataRowState)。
在 WriteToServerAsync(DataTable, DataRowState) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
Context Connection=true 指定於連接字串中。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
取消令牌已取消。 此例外狀況會儲存在傳回的工作中。
備註
如需 .NET Framework Data Provider for SQL Server 異步程式設計的詳細資訊，請參閱異步程序設計。
這個方法會儲存在工作中，它會傳回方法同步對應專案可以擲回的所有非使用狀況例外狀況。 如果例外狀況儲存在傳回的工作中，則會在等候工作時擲回該例外狀況。 使用狀況例外狀況，例如 ArgumentException，仍會同步擲回。 如需預存的例外狀況，請參閱 所 WriteToServer(DataTable, DataRowState)擲回的例外狀況。
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應