OracleCommand.ExecuteNonQuery Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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 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.