SqlBulkCopy.WriteToServerAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
非同期バージョンの WriteToServer。データ ソースのすべての行を、SqlBulkCopy オブジェクトの DestinationTableName プロパティで指定された宛先テーブルにコピーします。
オーバーロード
注釈
複数のアクティブな結果セット (MARS) が無効になっている場合は、 WriteToServer 接続がビジー状態になります。 MARS が有効になっている場合は、 の呼び出しを WriteToServer 同じ接続内の他のコマンドとインターリーブできます。
失敗した場合にロールバックされる行の数は、次のいくつかのことに依存します。
が指定されている場合 UseInternalTransaction 。
独自のトランザクションがある場合。
BatchSize の値。
サーバーへのデータの送信中にエラーが発生すると、現在のバッチ (で 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.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 に関連付けられたコネクションが閉じられました。
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.TaskPublic 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.TaskPublic 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 データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの 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.TaskPublic 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 データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。
このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの 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.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 に関連付けられたコネクションが閉じられました。
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.TaskPublic 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.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 オブジェクトは、メソッドの実行前に閉じられます。
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.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 オブジェクトは、メソッドの実行前に閉じられます。
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.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 オブジェクトは、メソッドの実行前に閉じられます。
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.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 オブジェクトは、メソッドの実行前に閉じられます。
Context Connection=true が接続文字列に指定されています。
タスク オブジェクトで返されたため、接続を開くときに発生した SQL Server によって返されるすべてのエラー。
キャンセル トークンが取り消されました。 この例外は、返されたタスクに格納されます。
注釈
SQL Serverの.NET Framework データ プロバイダーでの非同期プログラミングの詳細については、「非同期プログラミング」を参照してください。
このメソッドは、メソッドの同期的な例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクの待機時にスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって WriteToServer(DataTable, DataRowState)スローされる例外に関するページを参照してください。
適用対象
.NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示