次の方法で共有


SqlBulkCopy.WriteToServerAsync メソッド

定義

非同期バージョンの WriteToServer。データ ソースのすべての行を、SqlBulkCopy オブジェクトの DestinationTableName プロパティで指定された宛先テーブルにコピーします。

オーバーロード

WriteToServerAsync(IDataReader, CancellationToken)

WriteToServer(IDataReader) の非同期バージョン。指定した IDataReader のすべての行を、DestinationTableName オブジェクトの SqlBulkCopy プロパティで指定された対象テーブルにコピーします。

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

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 プロパティで指定されたコピー先テーブルにすべての行をコピーします。

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

WriteToServerAsync(DataTable, DataRowState)

非同期バージョンの WriteToServer(DataTable, DataRowState)。提供された DataTable 内の提供された行の状態と一致する行のみを、SqlBulkCopy オブジェクトの DestinationTableName のプロパティで指定されたコピー先のテーブルにコピーします。

WriteToServerAsync(DataTable, CancellationToken)

WriteToServer(DataTable) の非同期バージョン。指定した DataTable のすべての行を、DestinationTableName オブジェクトの SqlBulkCopy プロパティで指定された対象テーブルにコピーします。

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

非同期バージョンの WriteToServer(DataTable, DataRowState)。提供された DataTable 内の提供された行の状態と一致する行のみを、SqlBulkCopy オブジェクトの DestinationTableName のプロパティで指定されたコピー先のテーブルにコピーします。

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

注釈

複数のアクティブな結果セット (MARS) が無効になっている場合は、 WriteToServer 接続がビジー状態になります。 MARS が有効になっている場合は、 の呼び出しを WriteToServer 同じ接続内の他のコマンドとインターリーブできます。

失敗した場合にロールバックされる行の数は、次のいくつかのことに依存します。

サーバーへのデータの送信中にエラーが発生すると、現在のバッチ (で BatchSize指定) がロールバックされます。 が指定されておらず、独自のトランザクションがある場合 UseInternalTransaction 、トランザクション全体がロールバックされます (前のすべてのバッチも含まれます)。

サーバーにコピーされた行の数を確認するには、 を使用 SqlRowsCopied します。

WriteToServerAsync(IDataReader, CancellationToken)

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

cancellationToken
CancellationToken

取り消し命令。 このパラメーターの None 値により、このメソッドは WriteToServerAsync(DataTable) と同じになります。

戻り値

非同期操作を表すタスク。

例外

タスクの完了前に、同じインスタンスに対して WriteToServerAsync(IDataReader) を複数回呼び出す。

タスクを完了する前に同じインスタンスに対して WriteToServerAsync(IDataReader)WriteToServer(IDataReader) を呼び出します。

WriteToServerAsync(IDataReader) の実行中、接続は破棄されるか、または閉じられます。

タスク オブジェクトで返された場合、SqlBulkCopy オブジェクトは、メソッドの実行時に閉じられました。

タスク オブジェクトで返された場合、接続プールのタイムアウトが発生しました。

タスク オブジェクトで返された場合、SqlConnection オブジェクトは、メソッドの実行前に閉じられます。

完了した IDataReader が返される前に、Task が閉じられました。

完了した IDataReader が返される前に、Task に関連付けられたコネクションが閉じられました。

Context Connection=true が接続文字列に指定されています。

タスク オブジェクトで返されたため、接続を開くときに発生した SQL Server によって返されるすべてのエラー。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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

戻り値

非同期操作を表すタスク。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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 によって返されるすべてのエラー。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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 によって返されるすべてのエラー。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの 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 によって返されるすべてのエラー。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの 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 プロパティで指定されたコピー先テーブルにすべての行をコピーします。

キャンセル トークンを使用すると、コマンド タイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返されたタスク オブジェクトによって報告されます。

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 によって返されるすべてのエラー。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの 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 によって返されるすべてのエラー。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって WriteToServer(DataTable, DataRowState)スローされる例外に関するページを参照してください。

適用対象

WriteToServerAsync(DataTable, CancellationToken)

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

cancellationToken
CancellationToken

取り消し命令。 このパラメーターの None 値により、このメソッドは WriteToServerAsync(DataTable) と同じになります。

戻り値

非同期操作を表すタスク。

例外

タスクの完了前に、同じインスタンスに対して WriteToServerAsync(DataTable) を複数回呼び出す。

タスクを完了する前に同じインスタンスに対して WriteToServerAsync(DataTable)WriteToServer(DataTable) を呼び出します。

WriteToServerAsync(DataTable) の実行中、接続は破棄されるか、または閉じられます。

タスク オブジェクトで返された場合、SqlBulkCopy オブジェクトは、メソッドの実行時に閉じられました。

タスク オブジェクトで返された場合、接続プールのタイムアウトが発生しました。

タスク オブジェクトで返された場合、SqlConnection オブジェクトは、メソッドの実行前に閉じられます。

Context Connection=true が接続文字列に指定されています。

タスク オブジェクトで返されたため、接続を開くときに発生した SQL Server によって返されるすべてのエラー。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって WriteToServer(DataTable)スローされる例外に関するページを参照してください。

適用対象

WriteToServerAsync(DataTable, DataRowState, CancellationToken)

非同期バージョンの 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

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 によって返されるすべてのエラー。

キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。

注釈

SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。

このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって WriteToServer(DataTable, DataRowState)スローされる例外に関するページを参照してください。

適用対象