SqlBulkCopy.WriteToServerAsync 方法

定義

命名空間:: Microsoft.Data.SqlClient

組件:: Microsoft.Data.SqlClient.dll

套件:: Microsoft.Data.SqlClient v1.0.19269.1

套件:: Microsoft.Data.SqlClient v1.1.4

套件:: Microsoft.Data.SqlClient v2.0.1

套件:: Microsoft.Data.SqlClient v2.1.4

套件:: Microsoft.Data.SqlClient v3.0.1

套件:: Microsoft.Data.SqlClient v3.1.0

套件:: Microsoft.Data.SqlClient v4.0.1

套件:: Microsoft.Data.SqlClient v4.1.0

套件:: Microsoft.Data.SqlClient v5.0.0

套件:: Microsoft.Data.SqlClient v5.1.0

套件:: Microsoft.Data.SqlClient v5.2.0

套件:: Microsoft.Data.SqlClient v6.0.2

套件:: Microsoft.Data.SqlClient v6.1.3

套件:: Microsoft.Data.SqlClient v7.0.1

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
WriteToServerAsync(DbDataReader)	非同步版本 WriteToServer(IDataReader)，將所提供 IDataReader 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。
WriteToServerAsync(DataRow[])	非同步版本WriteToServer(DataRow[])的，將所有列從所提供DataRow陣列複製到由DestinationTableName SqlBulkCopy物件屬性指定的目的表。
WriteToServerAsync(DataTable)	非同步版本 WriteToServer(DataTable)，將所提供 DataTable 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。
WriteToServerAsync(IDataReader)	非同步版本 WriteToServer(IDataReader)，將所提供 IDataReader 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。
WriteToServerAsync(DbDataReader, CancellationToken)	非同步版本WriteToServer(DbDataReader)的，將所有列從所提供DbDataReader陣列複製到由DestinationTableName SqlBulkCopy物件屬性指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。
WriteToServerAsync(DataRow[], CancellationToken)	非同步版本WriteToServer(DataRow[])的，將所有列從所提供DataRow陣列複製到由DestinationTableName SqlBulkCopy物件屬性指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。
WriteToServerAsync(DataTable, DataRowState)	非同步版本WriteToServer(DataTable, DataRowState)，僅複製與所提供DataTable列狀態相符的列，送達由物件屬性SqlBulkCopy指定的DestinationTableName目的表。
WriteToServerAsync(DataTable, CancellationToken)	非同步版本 WriteToServer(DataTable)，將所提供 DataTable 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。
WriteToServerAsync(IDataReader, CancellationToken)	非同步版本 WriteToServer(IDataReader)，將所提供 IDataReader 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。
WriteToServerAsync(DataTable, DataRowState, CancellationToken)	非同步版本WriteToServer(DataTable, DataRowState)，僅複製與所提供DataTable列狀態相符的列，送達由物件屬性SqlBulkCopy指定的DestinationTableName目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

WriteToServerAsync(DbDataReader)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本 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.Task

Public Function WriteToServerAsync (reader As DbDataReader) As Task

參數

reader: DbDataReader

IDataReader A的列會被複製到目的資料表。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(IDataReader) 個實例呼叫多次，任務才完成。
WriteToServerAsync(IDataReader)呼叫和 WriteToServer(IDataReader) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(IDataReader) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
該建築 IDataReader 在完工 Task 前就已關閉。
IDataReader 該連結在完成Task前已關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(DataRow[])

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

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

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 物件在方法執行前會被關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(DataTable)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本 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 A的列會被複製到目的資料表。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(DataTable) 個實例呼叫多次，任務才完成。
WriteToServerAsync(DataTable)呼叫和 WriteToServer(DataTable) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(DataTable) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(IDataReader)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本 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 A的列會被複製到目的資料表。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(IDataReader) 個實例呼叫多次，任務才完成。
WriteToServerAsync(IDataReader)呼叫和 WriteToServer(IDataReader) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(IDataReader) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
該建築 IDataReader 在完工 Task 前就已關閉。
IDataReader 該連結在完成Task前已關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(DbDataReader, CancellationToken)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本WriteToServer(DbDataReader)的，將所有列從所提供DbDataReader陣列複製到由DestinationTableName SqlBulkCopy物件屬性指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

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 A的列會被複製到目的資料表。

cancellationToken: CancellationToken

取消指示。此 None 參數中的值使此方法等價於 WriteToServerAsync(DbDataReader)。

傳回

Task

一個代表非同步操作的任務。

適用於

WriteToServerAsync(DataRow[], CancellationToken)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本WriteToServer(DataRow[])的，將所有列從所提供DataRow陣列複製到由DestinationTableName SqlBulkCopy物件屬性指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

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 物件在方法執行前會被關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(DataTable, DataRowState)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本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 A的列會被複製到目的資料表。

rowState: DataRowState

一個來自 DataRowState 枚舉的數值。只有與列狀態相符的列會被複製到目的地。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(DataTable, DataRowState) 個實例呼叫多次，任務才完成。
WriteToServerAsync(DataTable, DataRowState)呼叫和 WriteToServer(DataTable, DataRowState) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(DataTable, DataRowState) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(DataTable, CancellationToken)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本 WriteToServer(DataTable)，將所提供 DataTable 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

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 A的列會被複製到目的資料表。

cancellationToken: CancellationToken

取消指示。此 None 參數中的值使此方法等價於 WriteToServerAsync(DataTable)。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(DataTable) 個實例呼叫多次，任務才完成。
WriteToServerAsync(DataTable)呼叫和 WriteToServer(DataTable) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(DataTable) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(IDataReader, CancellationToken)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本 WriteToServer(IDataReader)，將所提供 IDataReader 的所有列複製到由 DestinationTableName 物件屬性 SqlBulkCopy 指定的目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

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 A的列會被複製到目的資料表。

cancellationToken: CancellationToken

取消指示。此 None 參數中的值使此方法等價於 WriteToServerAsync(DataTable)。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(IDataReader) 個實例呼叫多次，任務才完成。
WriteToServerAsync(IDataReader)呼叫和 WriteToServer(IDataReader) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(IDataReader) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
該建築 IDataReader 在完工 Task 前就已關閉。
IDataReader 該連結在完成Task前已關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

來源:: SqlBulkCopy.cs

非同步版本WriteToServer(DataTable, DataRowState)，僅複製與所提供DataTable列狀態相符的列，送達由物件屬性SqlBulkCopy指定的DestinationTableName目的表。取消標記可用來請求在指令逾時前放棄操作。例外將透過回傳的任務物件回報。

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 A的列會被複製到目的資料表。

rowState: DataRowState

一個來自 DataRowState 枚舉的數值。只有與列狀態相符的列會被複製到目的地。

cancellationToken: CancellationToken

取消指示。此 None 參數中的值使此方法等價於 WriteToServerAsync(DataTable)。

傳回

Task

一個代表非同步操作的任務。

例外狀況

InvalidOperationException

在同一 WriteToServerAsync(DataTable, DataRowState) 個實例呼叫多次，任務才完成。
WriteToServerAsync(DataTable, DataRowState)呼叫和 WriteToServer(DataTable, DataRowState) 在任務完成前的同一個實例。
連線在執行過程中 WriteToServerAsync(DataTable, DataRowState) 會中斷或關閉。
在任務物件中回傳， SqlBulkCopy 該物件在方法執行時會被關閉。
任務物件回傳時，連線池有逾時。
在任務物件中回傳時，該 SqlConnection 物件在方法執行前會被關閉。
A SqlBulkCopyColumnOrderHint 未指定有效的目的地欄位名稱。

SqlException

在任務物件中回傳的是 SQL Server 在開啟連線時所回傳的任何錯誤。

備註

欲了解更多關於.NET框架Data Provider for SQL Server 非同步程式設計的資訊，請參見非同步程式設計。

適用於