OleDbCommand.ExecuteNonQuery メソッド

定義

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

Connectionに対して SQL ステートメントを実行し、影響を受けた行数を返します。

public:
 virtual int ExecuteNonQuery();
public:
 override int ExecuteNonQuery();
public int ExecuteNonQuery();
public override int ExecuteNonQuery();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
Public Overrides Function ExecuteNonQuery () As Integer

返品

Int32

影響を受ける行の数。

実装

ExecuteNonQuery()

例外

InvalidOperationException

接続が存在しません。

-または-

接続が開いていません。

-または-

接続が最初に参加していたコンテキストとは異なるトランザクション コンテキスト内でコマンドを実行することはできません。

例

次の例では、 OleDbCommand を作成し、 ExecuteNonQueryを使用して実行します。 この例では、UPDATE、INSERT、DELETE などの SQL ステートメントである文字列と、データ ソースへの接続に使用する文字列が渡されます。

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 です。 ロールバックが発生した場合、戻り値も -1 になります。

適用対象

こちらもご覧ください