OleDbCommand.ExecuteNonQuery-Methode

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.

Namespace: System.Data.OleDb
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Function ExecuteNonQuery As Integer
'Usage
Dim instance As OleDbCommand
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

Die Anzahl der betroffenen Zeilen.

Ausnahmen

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.

ExecuteNonQuery gibt 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.

Beispiel

Im folgenden Beispiel wird ein OleDbCommand erstellt und anschließend mit ExecuteNonQuery ausgeführt. Im Beispiel werden eine Zeichenfolge, die eine SQL-Anweisung (wie UPDATE, INSERT oder DELETE) ist, sowie eine Zeichenfolge, mit der eine Verbindung mit der Datenquelle hergestellt werden soll, übergeben.

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

static private void CreateOleDbCommand(
    string queryString, string connectionString)
{
    using (OleDbConnection connection = new 
               OleDbConnection(connectionString))
    {
        connection.Open();
        OleDbCommand command = new 
            OleDbCommand(queryString, connection);
        command.ExecuteNonQuery();
    }
}

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, 1.0

Siehe auch

Referenz

OleDbCommand-Klasse
OleDbCommand-Member
System.Data.OleDb-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen