OdbcCommand.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:
override int ExecuteNonQuery();public:
virtual int ExecuteNonQuery();public override int ExecuteNonQuery ();public int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intabstract member ExecuteNonQuery : unit -> int
override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerPublic Function ExecuteNonQuery () As IntegerGibt 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.
