IDbCommand.ExecuteNonQuery メソッド

.NET Framework データ プロバイダの Connection オブジェクトに対して SQL ステートメントを実行し、影響を受けた行の数を返します。

Function ExecuteNonQuery() As Integer
[C#]
int ExecuteNonQuery();
[C++]
int ExecuteNonQuery();
[JScript]
function ExecuteNonQuery() : int;

戻り値

影響を受けた行の数。

例外

例外の種類	条件
InvalidOperationException	接続が存在しません。 または 接続が開いていません。

解説

ExecuteNonQuery を使用して、カタログ操作 (データベース構造の照会、テーブルなどのデータベース オブジェクトの作成など) を実行できます。また、UPDATE、INSERT、または DELETE の各ステートメントを実行して、 DataSet を使用せずにデータベースのデータを変更できます。

ExecuteNonQuery は行を返しませんが、出力パラメータまたはパラメータに割り当てられた戻り値にデータが設定されます。

UPDATE、INSERT、DELETE の各ステートメントで、戻り値はそのコマンドの影響を受ける行の数です。その他のすべての種類のステートメントでは、戻り値は -1 です。

使用例

[Visual Basic, C#, C++] 派生クラス OleDbCommand のインスタンスを作成し、このインスタンスを実行する例を次に示します。この例では、SQL SELECT ステートメントである文字列と、データ ソースに接続するために使用する文字列をメソッドに渡します。

 
Public Sub CreateMyOleDbCommand(myExecuteQuery As String, _
myConnectionString As String)
    Dim myConnection As New OleDbConnection(myConnectionString)
    Dim myCommand As New OleDbCommand(myExecuteQuery, myConnection)
    myCommand.Connection.Open()
    myCommand.ExecuteNonQuery()
    MyConnection.Close()
End Sub

[C#] 
public void CreateMyOleDbCommand(string myExecuteQuery, string myConnectionString) 
{
   OleDbConnection myConnection = new OleDbConnection(myConnectionString);
   OleDbCommand myCommand = new OleDbCommand(myExecuteQuery, myConnection);
   myCommand.Connection.Open();
   myCommand.ExecuteNonQuery();
   myConnection.Close();
}

[C++] 
public:
 void CreateMyOleDbCommand(String* myExecuteQuery, String* myConnectionString) 
 {
    OleDbConnection* myConnection = new OleDbConnection(myConnectionString);
    OleDbCommand* myCommand = new OleDbCommand(myExecuteQuery, myConnection);
    myCommand->Connection->Open();
    myCommand->ExecuteNonQuery();
    myConnection->Close();
 }

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

IDbCommand インターフェイス | IDbCommand メンバ | System.Data 名前空間