OleDbCommand.ExecuteNonQuery メソッド

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

パッケージ:

System.Data.OleDb v8.0.0

ソース:

OleDbCommand.cs

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

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

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 になります。

こちらもご覧ください

• コマンドの操作