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 ExecuteNonQuery Zum Ausführen von Katalogvorgängen (z. B. Abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten wie Tabellen) oder zum Ändern der Daten in einer Datenbank verwenden, ohne eine DataSet, durch Ausführen von UPDATE-, INSERT- oder DELETE-Anweisungen auszuführen.
Sie können auch ExecuteNonQuery mehrere SQL Anweisungen ausfü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 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 allen anderen Anweisungstypen ist der Rückgabewert -1. Wenn ein Rollback auftritt, lautet der Rückgabewert auch -1.
Wenn ein Trigger in einer 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 von den Triggern oder Triggern betroffen sind.