SqlBatch.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 den Batch für sein Verbindungsobjekt aus, und gibt die Gesamtzahl der betroffenen Zeilen für alle Batchbefehle zurück.
public:
override int ExecuteNonQuery();public override int ExecuteNonQuery ();override this.ExecuteNonQuery : unit -> intPublic Overrides Function ExecuteNonQuery () As IntegerGibt zurück
Die Gesamtanzahl der Zeilen, die für alle Batchbefehle betroffen sind.
Hinweise
Sie können 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 durch Ausführen von UPDATE-, INSERT- oder DELETE-Anweisungen verwenden ExecuteNonQuery .
Obwohl ExecuteNonQuery keine Zeilen zurückgegeben werden, werden alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, mit Daten aufgefüllt.
Für UPDATE-, INSERT- und DELETE-Anweisungen ist der Rückgabewert die Gesamtanzahl der zeilen, die vom Batch betroffen sind. Wenn keine UPDATE-, INSERT- oder DELETE-Anweisungen im Batch enthalten sind, ist der Rückgabewert -1.
Hinweis
Diese Methode profitiert von ExecuteNonQuery(), und alle erwarteten Ausnahmen dieser Methode gelten auch hier.