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 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 geöffnet.
-oder-
Innerhalb eines Transaktionskontexts kann kein Befehl ausgeführt werden, der sich vom Kontext unterscheidet, in dem die Verbindung ursprünglich aufgelistet wurde.
Beispiele
Das folgende Beispiel erstellt ein OleDbCommand und führt es dann mithilfe ExecuteNonQueryvon . Das Beispiel wird eine Zeichenfolge übergeben, die eine SQL-Anweisung wie UPDATE, INSERT oder DELETE ist, 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 ExecuteNonQuery z. B. Katalogvorgänge ausführen, um die Struktur einer Datenbank abzufragen oder Datenbankobjekte wie Tabellen zu erstellen oder die Daten in einer Datenbank zu ändern, ohne dies DataSet zu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.
Obwohl die ExecuteNonQuery Rückgabe keine Zeilen zurückgibt, 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 Anzahl der zeilen, die vom Befehl betroffen sind. Für alle anderen Arten von Anweisungen lautet der Rückgabewert -1. Wenn ein Rollback auftritt, lautet der Rückgabewert auch -1.
