OdbcCommand.ExecuteNonQuery OdbcCommand.ExecuteNonQuery OdbcCommand.ExecuteNonQuery OdbcCommand.ExecuteNonQuery Method

Definition

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection and returns the number of rows affected.

public:
 virtual int ExecuteNonQuery();
public int ExecuteNonQuery ();
override this.ExecuteNonQuery : unit -> int
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.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.

Ausnahmen

Die Verbindung ist nicht vorhanden.The connection does not exist.

- oder --or-

Die Verbindung ist nicht geöffnet.The connection is not open.

Hinweise

Sie können verwenden ExecuteNonQuery , um Katalog Vorgänge auszuführen (z. b. Abfragen der Struktur einer Datenbank oder des Erstellens von Datenbankobjekten wie Tabellen) oder um die Daten in einer Datenbank ohne DataSetVerwendung von zu ändern, indem Sie Update, INSERT oder DELETE ausführen. Äußerungen.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, without using a DataSet, by executing UPDATE, INSERT, or DELETE statements.

Sie können auch verwenden ExecuteNonQuery , um mehrere SQL-Anweisungen auszuführen, wenn der zugrunde liegende ODBC-Treiber diese Funktionalität unterstützt.You can also use ExecuteNonQuery to execute multiple SQL statements if the underlying ODBC driver supports this functionality. In diesem Fall ist der Rückgabewert die Anzahl der Zeilen, die von allen Anweisungen im Befehl betroffen sind.In this case, the return value is the number of rows affected by all statements in the command.

Obwohl ExecuteNonQuery keine Zeilen zurückgibt, werden alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, mit Daten aufgefüllt.Although ExecuteNonQuery returns no 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. Wenn ein Rollback durchgeführt wird, ist auch der Rückgabewert-1.If a rollback occurs, the return value is also -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 vom Einfüge-oder Aktualisierungs Vorgang betroffen sind, sowie die Anzahl der Zeilen, auf die sich der Trigger oder Trigger auswirkt.When a trigger exists on a table and data is being added or changed in the table, the return value includes the number of rows affected by both the insert or update operation and the number of rows affected by the trigger or triggers.

Gilt für:

Siehe auch