OdbcCommand.ExecuteNonQuery-Methode
Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.
Namespace: System.Data.Odbc
Assembly: System.Data (in system.data.dll)
Syntax
'Declaration
Public Overrides Function ExecuteNonQuery As Integer
'Usage
Dim instance As OdbcCommand
Dim returnValue As Integer
returnValue = instance.ExecuteNonQuery
public override int ExecuteNonQuery ()
public:
virtual int ExecuteNonQuery () override
public int ExecuteNonQuery ()
public override function ExecuteNonQuery () : int
Rückgabewert
Bei UPDATE-Anweisungen, INSERT-Anweisungen und DELETE-Anweisungen ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei allen anderen Anweisungstypen ist der Rückgabewert -1.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die Verbindung ist nicht vorhanden. - oder - Die Verbindung ist nicht offen. |
Hinweise
Mit ExecuteNonQuery können Sie Katalogoperationen ausführen (z. B. das Abfragen der Struktur einer Datenbank oder das Erstellen von Datenbankobjekten wie Tabellen) oder die Daten in einer Datenbank ändern, ohne ein DataSet zu verwenden, indem Sie UPDATE-Anweisungen, INSERT-Anweisungen oder DELETE-Anweisungen ausführen.
Sie können mit ExecuteNonQuery auch mehrere SQL-Anweisungen ausführen, wenn ein solcher Vorgang vom zugrunde liegenden ODBC-Treiber unterstützt wird. In diesem Fall entspricht der Rückgabewert der Anzahl der Zeilen, die von allen Anweisungen im Befehl betroffen sind.
ExecuteNonQuery gibt zwar keine Zeilen zurück, aber Parametern zugeordnete Ausgabeparameter oder Rückgabewerte werden mit Daten aufgefüllt.
Bei UPDATE-Anweisungen, INSERT-Anweisungen und DELETE-Anweisungen ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Für alle anderen Anweisungstypen ist der Rückgabewert 1. Bei einem Rollback ist der Rückgabewert ebenfalls 1.
Plattformen
Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1
Siehe auch
Referenz
OdbcCommand-Klasse
OdbcCommand-Member
System.Data.Odbc-Namespace