IDbCommand.ExecuteNonQuery メソッド

定義

.NET データ プロバイダーの Connection オブジェクトに対して SQL ステートメントを実行し、影響を受ける行の数を返します。Executes an SQL statement against the Connection object of a .NET data provider, and returns the number of rows affected.

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

戻り値

Int32

影響を受けた行の数。The number of rows affected.

例外

接続が存在しません。The connection does not exist.

または-or-

接続が開かれていません。The connection is not open.

次の例では、派生クラスのインスタンスを作成 OleDbCommand し、それを実行します。The following example creates an instance of the derived class, OleDbCommand, and then executes it. これを実現するために、メソッドには、SQL SELECT ステートメントである文字列と、データソースへの接続に使用する文字列が渡されます。To accomplish this, the method is passed a string that is a SQL SELECT statement and a string to use to connect to the data source.

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 DataSet UPDATE、INSERT、または DELETE ステートメントを実行して、カタログの操作 (データベースの構造の照会、テーブルなどのデータベースオブジェクトの作成など) を実行したり、を使用せずにデータベース内のデータを変更したりすることができます。You can use the ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database without using a DataSet by executing UPDATE, INSERT, or DELETE statements.

ExecuteNonQuery 行を返しませんが、パラメーターにマップされた出力パラメーターまたは戻り値にはデータが設定されます。Although the ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data.

UPDATE、INSERT、DELETE の各ステートメントで、戻り値はそのコマンドの影響を受ける行の数です。For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. その他のすべての種類のステートメントでは、戻り値は -1 です。For all other types of statements, the return value is -1.

適用対象