IDbCommand.ExecuteNonQuery Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.dll

Führt eine SQL-Anweisung für das objekt Connection 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 geöffnet.

Beispiele

Im folgenden Beispiel wird eine Instanz der abgeleiteten Klasse OleDbCommanderstellt und anschließend ausgeführt. Dazu wird die Methode eine Zeichenfolge übergeben, die eine SQL SELECT-Anweisung und eine Zeichenfolge ist, 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 die Katalogoperationen (z. B. Abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten wie Tabellen) oder zum Ändern der Daten in einer Datenbank ohne Verwendung DataSet durch Ausführen von UPDATE-, INSERT- oder DELETE-Anweisungen verwendenExecuteNonQuery.

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

Für UPDATE-, INSERT- und DELETE-Anweisungen ist der Rückgabewert die Anzahl der zeilen, die vom Befehl betroffen sind. Für alle anderen Arten von Anweisungen lautet der Rückgabewert -1.