DbCommand.ExecuteNonQuery Methode

Definition

Führt bei Überschreibung in einer abgeleiteten Klasse eine SQL-Anweisung für ein Verbindungsobjekt aus.When overridden in a derived class, executes a SQL statement against a connection object.

public:
 abstract int ExecuteNonQuery();
public abstract int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
Public MustOverride Function ExecuteNonQuery () As Integer

Gibt zurück

Die Anzahl der betroffenen Zeilen.The number of rows affected.

Implementiert

Hinweise

Sie können ExecuteNonQuery zum Ausführen von Katalog Operationen (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.You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database by executing UPDATE, INSERT, or DELETE statements.

Obwohl ExecuteNonQuery keine Zeilen zurückgibt, werden alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, mit Daten aufgefüllt.Although ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data.

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen.For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command. Bei allen anderen Anweisungstypen ist der Rückgabewert -1.For all other types of statements, the return value is -1.

Gilt für:

Siehe auch