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.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が閉じられました。
完了したTaskが返される前に、IDataReaderの関連付けられている接続が閉じられました。
Context Connection=trueは、接続文字列で指定します。
タスク オブジェクトで返されます。接続を開くときに発生したSQL Serverによって返されたエラー。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(IDataReader)によってスローされる例外を参照してください。
適用対象
WriteToServerAsync(DbDataReader)
WriteToServer(DbDataReader)の非同期バージョン。指定されたDbDataReader配列から、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
コピー先テーブルに行がコピーされる DbDataReader 。
返品
非同期操作を表すタスク。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(DbDataReader)によってスローされる例外を参照してください。
適用対象
WriteToServerAsync(DataRow[])
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
パラメーター
返品
非同期操作を表すタスク。
例外
タスクの完了前に、同じインスタンスに対して複数回 WriteToServerAsync(DataRow[]) 呼び出します。
タスクが完了する前に、同じインスタンスの WriteToServerAsync(DataRow[]) と WriteToServer(DataRow[]) を呼び出します。
接続が切断されるか、 WriteToServerAsync(DataRow[]) 実行中に閉じられます。
タスク オブジェクトで返された SqlBulkCopy オブジェクトは、メソッドの実行中に閉じられました。
タスク オブジェクトで返され、接続プールのタイムアウトが発生しました。
タスク オブジェクトで返された SqlConnection オブジェクトは、メソッドの実行前に閉じられます。
Context Connection=trueは、接続文字列で指定します。
タスク オブジェクトで返されます。接続を開くときに発生したSQL Serverによって返されたエラー。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 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
パラメーター
返品
非同期操作を表すタスク。
例外
タスクの完了前に、同じインスタンスに対して複数回 WriteToServerAsync(DataTable) 呼び出します。
タスクが完了する前に、同じインスタンスの WriteToServerAsync(DataTable) と WriteToServer(DataTable) を呼び出します。
接続が切断されるか、 WriteToServerAsync(DataTable) 実行中に閉じられます。
タスク オブジェクトで返された SqlBulkCopy オブジェクトは、メソッドの実行中に閉じられました。
タスク オブジェクトで返され、接続プールのタイムアウトが発生しました。
タスク オブジェクトで返された SqlConnection オブジェクトは、メソッドの実行前に閉じられます。
Context Connection=trueは、接続文字列で指定します。
タスク オブジェクトで返されます。接続を開くときに発生したSQL Serverによって返されたエラー。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 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が閉じられました。
完了したTaskが返される前に、IDataReaderの関連付けられている接続が閉じられました。
Context Connection=trueは、接続文字列で指定します。
タスク オブジェクトで返されます。接続を開くときに発生したSQL Serverによって返されたエラー。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(IDataReader)によってスローされる例外を参照してください。
適用対象
WriteToServerAsync(DbDataReader, CancellationToken)
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 。
- cancellationToken
- CancellationToken
取り消し命令。 このパラメーターに None 値を指定すると、このメソッドは WriteToServerAsync(DbDataReader)と同等になります。
返品
Task を返します。
例外
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(DbDataReader)によってスローされる例外を参照してください。
適用対象
WriteToServerAsync(DataRow[], CancellationToken)
WriteToServer(DataRow[])の非同期バージョン。指定されたDataRow配列から、DestinationTableName オブジェクトのSqlBulkCopy プロパティで指定されたコピー先テーブルにすべての行がコピーされます。
キャンセル トークンを使用して、コマンドのタイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返された 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
パラメーター
- cancellationToken
- CancellationToken
取り消し命令。 このパラメーターに None 値を指定すると、このメソッドは WriteToServerAsync(DataTable)と同等になります。
返品
非同期操作を表すタスク。
例外
タスクの完了前に、同じインスタンスに対して複数回 WriteToServerAsync(DataRow[]) 呼び出します。
タスクが完了する前に、同じインスタンスの WriteToServerAsync(DataRow[]) と WriteToServer(DataRow[]) を呼び出します。
接続が切断されるか、 WriteToServerAsync(DataRow[]) 実行中に閉じられます。
タスク オブジェクトで返された SqlBulkCopy オブジェクトは、メソッドの実行中に閉じられました。
タスク オブジェクトで返され、接続プールのタイムアウトが発生しました。
タスク オブジェクトで返された SqlConnection オブジェクトは、メソッドの実行前に閉じられます。
Context Connection=trueは、接続文字列で指定します。
タスク オブジェクトで返されます。接続を開くときに発生したSQL Serverによって返されたエラー。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(DataRow[])によってスローされる例外を参照してください。
適用対象
WriteToServerAsync(DataTable, DataRowState)
WriteToServer(DataTable, DataRowState)の非同期バージョン。指定されたDataTableの指定された行の状態と一致する行のみが、DestinationTableName オブジェクトのSqlBulkCopy プロパティで指定された変換先テーブルにコピーされます。
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
パラメーター
- 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 Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 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
パラメーター
- cancellationToken
- CancellationToken
取り消し命令。 このパラメーターに None 値を指定すると、このメソッドは WriteToServerAsync(DataTable)と同等になります。
返品
非同期操作を表すタスク。
例外
タスクの完了前に、同じインスタンスに対して複数回 WriteToServerAsync(DataTable) 呼び出します。
タスクが完了する前に、同じインスタンスの WriteToServerAsync(DataTable) と WriteToServer(DataTable) を呼び出します。
接続が切断されるか、 WriteToServerAsync(DataTable) 実行中に閉じられます。
タスク オブジェクトで返された SqlBulkCopy オブジェクトは、メソッドの実行中に閉じられました。
タスク オブジェクトで返され、接続プールのタイムアウトが発生しました。
タスク オブジェクトで返された SqlConnection オブジェクトは、メソッドの実行前に閉じられます。
Context Connection=trueは、接続文字列で指定します。
タスク オブジェクトで返されます。接続を開くときに発生したSQL Serverによって返されたエラー。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
SQL Serverの.NET Framework Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(DataTable)によってスローされる例外を参照してください。
適用対象
WriteToServerAsync(DataTable, DataRowState, CancellationToken)
WriteToServer(DataTable, DataRowState)の非同期バージョン。指定されたDataTableの指定された行の状態と一致する行のみが、DestinationTableName オブジェクトのSqlBulkCopy プロパティで指定された変換先テーブルにコピーされます。
キャンセル トークンを使用して、コマンドのタイムアウトが経過する前に操作を破棄するように要求できます。 例外は、返された 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
パラメーター
- 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 Data Providerでの非同期プログラミングの詳細については、「Asynchronous Programming」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 WriteToServer(DataTable, DataRowState)によってスローされる例外を参照してください。