IDbCommand.ExecuteNonQuery メソッド

定義

名前空間:
System.Data
アセンブリ:
System.Data.dll
アセンブリ:
netstandard.dll

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

public:
 int ExecuteNonQuery();
public int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

返品

Int32

影響を受ける行の数。

例外

InvalidOperationException

接続が存在しません。

-または-

接続が開いていません。

例

次の例では、派生クラスのインスタンスを作成し、 OleDbCommandしてから実行します。 これを実現するために、このメソッドには SQL SELECT ステートメントである文字列と、データ ソースへの接続に使用する文字列が渡されます。

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

Private Sub CreateOleDbCommand( _
    ByVal queryString As String, ByVal connectionString As String)
    Using connection As New OleDbConnection(connectionString)
        connection.Open()
        Dim command As New OleDbCommand(queryString, connection)
        command.ExecuteNonQuery()
    End Using
End Sub

注釈

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

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

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

適用対象