SqlBulkCopy.WriteToServerAsync 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
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物件在方法執行之前關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 中非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
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物件在方法執行之前關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 中非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
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物件在方法執行之前關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 中非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
WriteToServerAsync(DbDataReader, CancellationToken)
WriteToServer(DbDataReader) 的非同步版本，它會將所有資料列從提供的 DbDataReader 陣列複製到 SqlBulkCopy 物件之 DestinationTableName 屬性所指定的目的資料表。
取消語彙基元可用於要求在命令逾時之前捨棄作業。 例外狀況將經由傳回的 Task 物件回報。
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)。
傳回
表示非同步作業的工作。
適用於
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物件在方法執行之前關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
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物件在方法執行之前關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
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物件在方法執行之前關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
WriteToServerAsync(DbDataReader)
WriteToServer(IDataReader) 的非同步版本，其會將提供的 IDataReader 中的所有資料列複製到 DestinationTableName 物件的 SqlBulkCopy 屬性所指定的目的資料表。
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
IDataReader，其資料列會複製到目的資料表。
傳回
表示非同步作業的工作。
例外狀況
在工作完成前，多次呼叫同一個執行個體的 WriteToServerAsync(IDataReader)。
在工作完成前為相同的執行個體呼叫 WriteToServerAsync(IDataReader) 和 WriteToServer(IDataReader)。
在 WriteToServerAsync(IDataReader) 執行期間，連線中斷或關閉。
在工作物件中傳回，SqlBulkCopy物件在方法執行期間關閉。
在工作物件中傳回，發生連接集區逾時。
在工作物件中傳回，SqlConnection物件在方法執行之前關閉。
IDataReader在已完成的Task傳回之前已關閉。
IDataReader的關聯連接在已完成的Task傳回之前已關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
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傳回之前已關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。
適用於
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傳回之前已關閉。
SqlBulkCopyColumnOrderHint未指定有效的目的地資料行名稱。
於工作物件中傳回，SQL Server 傳回於開啟連線時所發生的任何錯誤。
備註
如需 .NET Framework Data Provider for SQL Server 非同步程式設計的詳細資訊，請參閱非同步程式設計。