OracleCommand.ExecuteNonQuery Methode

Definition

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

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

public:
 override int ExecuteNonQuery();

public override int ExecuteNonQuery ();

override this.ExecuteNonQuery : unit -> int

Public Overrides Function ExecuteNonQuery () As Integer

Gibt zurück

Int32

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei CREATE TABLE- oder DROP TABLE-Anweisungen ist der Rückgabewert 0. Bei allen anderen Anweisungstypen ist der Rückgabewert -1.

Ausnahmen

InvalidOperationException

Die Verbindung ist nicht vorhanden.

- oder -

Die Verbindung ist nicht offen.

Beispiele

Im folgenden Beispiel wird ein OracleCommand erstellt und dann mit ExecuteNonQueryausgeführt. Im Beispiel wird eine Zeichenfolge übergeben, bei der es sich um eine SQL-Anweisung (z. B. UPDATE, INSERT oder DELETE) und eine Zeichenfolge handelt, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden soll.

public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery, connection);
        command.Connection.Open();
        command.ExecuteNonQuery();
    }
}

Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

Hinweise

Sie können verwenden ExecuteNonQuery , 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 eine DataSetzu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.

Gibt zwar ExecuteNonQuery keine Zeilen zurück, aber alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, werden mit Daten aufgefüllt.

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei CREATE TABLE- oder DROP TABLE-Anweisungen ist der Rückgabewert 0. Bei allen anderen Anweisungstypen ist der Rückgabewert -1. Wenn ein Rollback auftritt, ist der Rückgabewert ebenfalls -1.

Weitere Informationen

• Arbeiten mit Befehlen