IDbCommand.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 das Connection-Objekt eines .NET-Datenanbieters aus und gibt die Anzahl der betroffenen Zeilen zurück.
public:
int ExecuteNonQuery();public int ExecuteNonQuery ();abstract member ExecuteNonQuery : unit -> intPublic Function ExecuteNonQuery () As IntegerGibt zurück
Die Anzahl der betroffenen Zeilen.
Ausnahmen
Die Verbindung ist nicht vorhanden.
- oder -
Die Verbindung ist nicht offen.
Beispiele
Im folgenden Beispiel wird eine instance der abgeleiteten Klasse erstellt und OleDbCommanddann ausgeführt. Um dies zu erreichen, wird der -Methode eine Zeichenfolge übergeben, die eine SQL SELECT-Anweisung 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 den ExecuteNonQuery verwenden, um Katalogvorgänge auszuführen (z. B. abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten wie Tabellen) oder um die Daten in einer Datenbank zu ändern, ohne ein DataSet zu verwenden, indem Sie UPDATE-, INSERT- oder DELETE-Anweisungen ausführen.
Obwohl keine ExecuteNonQuery Zeilen zurückgegeben werden, 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.
