Freigeben über


OleDbCommand.ExecuteNonQuery Methode

Definition

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.

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

Gibt zurück

Die Anzahl der betroffenen Zeilen.

Implementiert

Ausnahmen

Die Verbindung ist nicht vorhanden.

- oder -

Die Verbindung ist nicht offen.

- oder -

Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.

Beispiele

Im folgenden Beispiel wird ein OleDbCommand erstellt und dann mit ExecuteNonQueryausgeführt. Das Beispiel wird eine Zeichenfolge übergeben, bei der es sich um eine SQL-Anweisung wie UPDATE, INSERT oder DELETE handelt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll.

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

Sie können den ExecuteNonQuery verwenden, um Katalogvorgänge auszuführen, z. B. zum Abfragen der Struktur einer Datenbank oder zum Erstellen von Datenbankobjekten wie Tabellen oder zum Ändern der Daten in einer Datenbank, ohne ein DataSet zu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.

Obwohl der ExecuteNonQuery keine Zeilen zurückgibt, werden alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, mit Daten aufgefüllt.

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei allen anderen Anweisungstypen ist der Rückgabewert -1. Wenn ein Rollback erfolgt, ist auch der Rückgabewert -1.

Gilt für:

Weitere Informationen