IDbCommand.ExecuteNonQuery Methode

Definition

Führt eine SQL-Anweisung für das Connection-Objekt eines .NET-Datenanbieters aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection object of a .NET data provider, and returns the number of rows affected.

public:
 int ExecuteNonQuery();
public int ExecuteNonQuery ();
abstract member ExecuteNonQuery : unit -> int
Public Function ExecuteNonQuery () As Integer

Gibt zurück

Int32

Die Anzahl der betroffenen Zeilen.The number of rows affected.

Ausnahmen

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

- oder --or-

Die Verbindung ist nicht offen.The connection is not open.

Beispiele

Im folgenden Beispiel wird eine Instanz der abgeleiteten Klasse erstellt OleDbCommand und dann ausgeführt.The following example creates an instance of the derived class, OleDbCommand, and then executes it. Um dies zu erreichen, wird der Methode eine Zeichenfolge mit einer SQL-SELECT-Anweisung und einer Zeichenfolge, die zum Herstellen einer Verbindung mit der Datenquelle verwendet wird, übermittelt.To accomplish this, the method is passed a string that is a SQL SELECT statement and a string to use to connect to the data source.

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 zum ExecuteNonQuery Ausführen von Katalog Operationen (z. b. Abfragen der Struktur einer Datenbank oder Erstellen von Datenbankobjekten, z. b. Tabellen) oder zum Ändern der Daten in einer Datenbank ohne eine DataSet durch Ausführen von Update-, INSERT-oder DELETE-Anweisungen verwenden.You can use the 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.

Obwohl keine ExecuteNonQuery Zeilen zurückgibt, werden alle Ausgabeparameter oder Rückgabewerte, die Parametern zugeordnet sind, mit Daten aufgefüllt.Although the ExecuteNonQuery does not return any 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.

Gilt für: