OleDbCommand.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
Die Anzahl der betroffenen Zeilen.
Implementiert
Ausnahmen
Die Verbindung ist nicht vorhanden.
- oder -
Die Verbindung ist nicht offen.
- oder -
Ein Befehl in einem Transaktionskontext, der von dem Kontext abweicht, in dem die Verbindung ursprünglich eingetragen wurde, kann nicht ausführt werden.
Beispiele
Im folgenden Beispiel wird ein OleDbCommand erstellt und dann mit ExecuteNonQueryausgeführt. Das Beispiel wird eine Zeichenfolge übergeben, bei der es sich um eine SQL-Anweisung wie UPDATE, INSERT oder DELETE handelt, und eine Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet werden soll.
static private void CreateOleDbCommand(
string queryString, string connectionString)
{
using (OleDbConnection connection = new
OleDbConnection(connectionString))
{
connection.Open();
OleDbCommand command = new
OleDbCommand(queryString, connection);
command.ExecuteNonQuery();
}
}
Private Sub CreateOleDbCommand( _
ByVal queryString As String, ByVal connectionString As String)
Using connection As New OleDbConnection(connectionString)
connection.Open()
Dim command As New OleDbCommand(queryString, connection)
command.ExecuteNonQuery()
End Using
End Sub
Hinweise
Sie können den ExecuteNonQuery verwenden, um Katalogvorgänge auszuführen, z. B. zum Abfragen der Struktur einer Datenbank oder zum Erstellen von Datenbankobjekten wie Tabellen oder zum Ändern der Daten in einer Datenbank, ohne ein DataSet zu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.
Obwohl der ExecuteNonQuery keine Zeilen zurückgibt, werden alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, mit Daten aufgefü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 erfolgt, ist auch der Rückgabewert -1.
