OracleCommand.ExecuteNonQuery Methode

Definition

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

public:
 virtual int ExecuteNonQuery();
public:
 override int ExecuteNonQuery();
public int ExecuteNonQuery ();
public override int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer
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.

Implementiert

Ausnahmen

Die Verbindung ist nicht vorhanden.

- oder -

Die Verbindung ist nicht offen.

Beispiele

Im folgenden Beispiel wird eine OracleCommand Datei erstellt und dann mithilfe ExecuteNonQueryvon . Das Beispiel wird eine Zeichenfolge übergeben, die eine SQL-Anweisung (z. B. UPDATE, INSERT oder DELETE) und eine Zeichenfolge ist, 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 ExecuteNonQuery Katalogvorgänge ausführen (z. B. abfragen die Struktur einer Datenbank oder das Erstellen von Datenbankobjekten wie Tabellen); oder um die Daten in einer Datenbank zu ändern, ohne eine , indem DataSetSie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.

Obwohl ExecuteNonQuery keine Zeilen zurückgegeben werden, werden alle Ausgabeparameter oder Rückgabewerte zurückgegeben, die Parametern zugeordnet sind, mit Daten gefü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 auch -1.

Gilt für

Siehe auch