OracleCommand.ExecuteNonQuery-Methode

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

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

Syntax

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

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei CREATE TABLE-Anweisungen und DROP TABLE-Anweisungen ist der Rückgabewert 0. Bei allen anderen Änderungstypen ist der Rückgabewert -1.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidOperationException	Die Verbindung ist nicht vorhanden. - oder - Die Verbindung ist nicht offen.

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 die entsprechende Anweisung UPDATE, INSERT oder DELETE ausführen.

Obwohl ExecuteNonQuery keine Zeilen zurückgibt, werden die einem Parameter zugeordneten Ausgabeparameter oder Rückgabewerte mit Daten gefüllt.

Bei den Anweisungen UPDATE, INSERT und DELETE ist der Rückgabewert die Anzahl der vom Befehl betroffenen Zeilen. Bei CREATE TABLE-Anweisungen und DROP TABLE-Anweisungen ist der Rückgabewert 0. Bei allen anderen Anweisungen ist der Rückgabewert -1. Bei einem Rollback ist der Rückgabewert ebenfalls -1.

Beispiel

Im folgenden Beispiel wird ein OracleCommand 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 zu der Datenbank erstellt werden soll, übergeben.

Public Sub CreateOracleCommand(ByVal myExecuteQuery As String, _
ByVal connectionString As String)
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(myExecuteQuery, connection)
        command.Connection.Open()
        command.ExecuteNonQuery()
    End Using
End Sub

public void CreateOracleCommand(string myExecuteQuery, string connectionString)
{
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(myExecuteQuery, connection);
        command.Connection.Open();
        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

Siehe auch

Referenz

OracleCommand-Klasse
OracleCommand-Member
System.Data.OracleClient-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen