SqlCommand.EndExecuteNonQuery メソッド

.NET Framework クラス ライブラリ リファレンス

SqlCommand.EndExecuteNonQuery メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

Transact-SQL ステートメントの非同期実行を完了します。

名前空間: System.Data.SqlClient
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function EndExecuteNonQuery ( _
    asyncResult As IAsyncResult _
) As Integer

Visual Basic (使用法)

Dim instance As SqlCommand
Dim asyncResult As IAsyncResult
Dim returnValue As Integer

returnValue = instance.EndExecuteNonQuery(asyncResult)

C#

public int EndExecuteNonQuery (
    IAsyncResult asyncResult
)

C++

public:
int EndExecuteNonQuery (
    IAsyncResult^ asyncResult
)

J#

public int EndExecuteNonQuery (
    IAsyncResult asyncResult
)

JScript

public function EndExecuteNonQuery (
    asyncResult : IAsyncResult
) : int

パラメータ

asyncResult

BeginExecuteNonQuery の呼び出しで返される IAsyncResult。

戻り値
影響を受けた行の数 (ExecuteNonQuery と同じ動作)。

例外

例外の種類	条件
ArgumentException	asyncResult パラメータが null (Microsoft Visual Basic の場合は Nothing) です。
InvalidOperationException	単一のコマンド実行に対して EndExecuteNonQuery が複数回呼び出されたか、実行メソッドに対して不適切なメソッドが呼び出されました (たとえば、BeginExecuteXmlReader の呼び出しの実行を完了するために、コードで EndExecuteNonQuery を呼び出した場合)。

解説

BeginExecuteNonQuery を呼び出して Transact-SQL ステートメントを実行する場合は、EndExecuteNonQuery を呼び出して、操作を完了させる必要があります。コマンドの実行プロセスが完了していない場合、このメソッドは操作の完了までブロック状態になります。コマンドの操作が完了しているかどうかは、BeginExecuteNonQuery メソッドによって返された IAsyncResult のインスタンスを使用して確認できます。BeginExecuteNonQuery の呼び出しでコールバック プロシージャを指定した場合、このメソッドを呼び出す必要があります。

使用例

EndExecuteNonQuery メソッドの実際の使用例については、「BeginExecuteNonQuery」および「BeginExecuteNonQuery」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlCommand クラス
SqlCommand メンバ
System.Data.SqlClient 名前空間
その他の技術情報
ADO.NET でのデータへの接続およびデータの取得
.NET Framework Data Provider for SQL Server の使用