共用方式為


SqlBulkCopy.WriteToServerAsync 方法

定義

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)

傳回

表示非同步作業的工作。

例外狀況

在工作完成前,多次呼叫同一個執行個體的 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.Task
Public 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.Task
Public Function WriteToServerAsync (rows As DataRow()) As Task

參數

rows
DataRow[]

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

傳回

表示非同步作業的工作。

例外狀況

在工作完成前,多次呼叫同一個執行個體的 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.Task
Public Function WriteToServerAsync (table As DataTable) As Task

參數

table
DataTable

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(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,其資料列會複製到目的資料表。

傳回

表示非同步作業的工作。

例外狀況

在工作完成前,多次呼叫同一個執行個體的 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.Task
Public 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.Task
Public Function WriteToServerAsync (rows As DataRow(), cancellationToken As CancellationToken) As Task

參數

rows
DataRow[]

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

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.Task
Public Function WriteToServerAsync (table As DataTable, rowState As DataRowState) As Task

參數

table
DataTable

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

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.Task
Public Function WriteToServerAsync (table As DataTable, cancellationToken As CancellationToken) As Task

參數

table
DataTable

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

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.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)

傳回

表示非同步作業的工作。

例外狀況

在工作完成前,多次呼叫同一個執行個體的 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)擲回的例外狀況。

適用於