OleDbCommand.ExecuteNonQuery OleDbCommand.ExecuteNonQuery OleDbCommand.ExecuteNonQuery OleDbCommand.ExecuteNonQuery Method

Definition

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection and returns the number of rows affected.

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

Gibt zurück

Die Anzahl der betroffenen Zeilen.The number of rows affected.

Implementiert

Ausnahmen

Die Verbindung ist nicht vorhanden.The connection does not exist.

- oder --or-

Die Verbindung ist nicht geöffnet.The connection is not open.

- oder --or-

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.Cannot execute a command within a transaction context that differs from the context in which the connection was originally enlisted.

Beispiele

Das folgende Beispiel erstellt eine OleDbCommand und führt dann mit ExecuteNonQuery.The following example creates an OleDbCommand and then executes it using ExecuteNonQuery. Im Beispiel wird übergeben, eine Zeichenfolge, die eine SQL­Anweisung z. B. Update-, INSERT- oder DELETE ist, und eine Zeichenfolge, für die Verbindung mit der Datenquelle verwendet.The example is passed a string that is an SQL statement such as UPDATE, INSERT, or DELETE, 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

Hinweise

Können Sie die ExecuteNonQuery zu Katalogoperationen, z. B. ausführen, um die Struktur einer Datenbank abzufragen oder Erstellen von Datenbankobjekten, z. B. Tabellen oder So ändern Sie die Daten in einer Datenbank ohne Verwendung einer DataSet durch Ausführen von Update-, INSERT- oder DELETE -Anweisungen.You can use the ExecuteNonQuery to perform catalog operations, for example, to query the structure of a database or to create database objects such as tables, or to change the data in a database without using a DataSet by executing UPDATE, INSERT, or DELETE statements.

Obwohl die ExecuteNonQuery gibt keine Zeilen zurück, das alle Ausgabeparameter oder Rückgabewerte Parametern zugeordnete mit Daten aufgefüllt werden.Although the ExecuteNonQuery returns no rows, any output parameters or return values mapped to parameters are populated with data.

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Bei allen anderen Anweisungstypen ist der Rückgabewert -1.For all other types of statements, the return value is -1. Wenn ein Rollback ausgeführt wird, ist der Rückgabewert auch -1.If a rollback occurs, the return value is also -1.

Gilt für:

Siehe auch