IDbCommand.ExecuteNonQuery Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

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

public:
 int ExecuteNonQuery();

public int ExecuteNonQuery ();

abstract member ExecuteNonQuery : unit -> int

Public Function ExecuteNonQuery () As Integer

Gibt zurück

Int32

Die Anzahl der betroffenen Zeilen.

Ausnahmen

InvalidOperationException

Die Verbindung ist nicht vorhanden.

- oder -

Die Verbindung ist nicht offen.

Beispiele

Im folgenden Beispiel wird eine instance der abgeleiteten Klasse erstellt und OleDbCommanddann ausgeführt. Um dies zu erreichen, wird der -Methode eine Zeichenfolge übergeben, die eine SQL SELECT-Anweisung ist, 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. abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten wie Tabellen) oder um die Daten in einer Datenbank zu ändern, ohne ein DataSet zu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.

Obwohl keine ExecuteNonQuery Zeilen zurückgegeben werden, 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.