Freigeben über


OdbcCommand.ExecuteNonQuery Methode

Definition

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

public:
 override int ExecuteNonQuery();
public:
 virtual int ExecuteNonQuery();
public override int ExecuteNonQuery ();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
abstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> int
Public Overrides Function ExecuteNonQuery () As Integer
Public 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 allen anderen Anweisungstypen ist der Rückgabewert -1.

Implementiert

Ausnahmen

Die Verbindung ist nicht vorhanden.

- oder -

Die Verbindung ist nicht offen.

Hinweise

Sie können zum Ausführen von Katalogvorgängen ExecuteNonQuery (z. B. abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten wie Tabellen) oder zum Ändern der Daten in einer Datenbank verwenden, ohne einen DataSetzu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.

Sie können auch verwenden ExecuteNonQuery , um mehrere SQL-Anweisungen auszuführen, wenn der zugrunde liegende ODBC-Treiber diese Funktionalität unterstützt. In diesem Fall ist der Rückgabewert die Anzahl der Zeilen, die von allen Anweisungen im Befehl betroffen sind.

Obwohl ExecuteNonQuery keine 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. Wenn ein Rollback erfolgt, ist auch der Rückgabewert -1.

Wenn ein Trigger für eine Tabelle vorhanden ist und Daten in der Tabelle hinzugefügt oder geändert werden, enthält der Rückgabewert die Anzahl der Zeilen, die sowohl vom Einfüge- oder Aktualisierungsvorgang betroffen sind, als auch die Anzahl der Zeilen, die vom Trigger oder den Triggern betroffen sind.

Gilt für:

Weitere Informationen