OracleCommand-Klasse

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die für eine Datenbank ausgeführt werden soll. Die Klasse kann nicht vererbt werden.

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

Syntax

'Declaration
Public NotInheritable Class OracleCommand
    Inherits DbCommand
    Implements ICloneable
'Usage
Dim instance As OracleCommand

public sealed class OracleCommand : DbCommand, ICloneable

public ref class OracleCommand sealed : public DbCommand, ICloneable

public final class OracleCommand extends DbCommand implements ICloneable

public final class OracleCommand extends DbCommand implements ICloneable

Hinweise

Die OracleCommand-Klasse stellt folgende Methoden zum Ausführen von Befehlen für eine Datenquelle bereit:

Element	Beschreibung
ExecuteReader	Führt Befehle aus, die Zeilen zurückgeben.
ExecuteOracleNonQuery	Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteNonQuery	Führt Befehle wie die SQL-Anweisungen INSERT, DELETE, UPDATE und SET aus.
ExecuteScalar	Ruft einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank als .NET Framework-Datentyp ab.
ExecuteOracleScalar	Ruft einen einzelnen Wert (z. B. einen Aggregatwert) aus einer Datenbank als Oracle-Datentyp ab.

Sie können die CommandText-Eigenschaft zurücksetzen und das OracleCommand-Objekt wiederverwenden.

Wenn das Ausführen des Befehls zu einer schwerwiegenden OracleException führt, wird die OracleConnection möglicherweise geschlossen. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Hinweis

Im Gegensatz zum Command-Objekt anderer .NET Framework-Datenanbieter (SQL Server, OLE DB und ODBC) unterstützt das OracleCommand-Objekt keine CommandTimeout-Eigenschaft. Das Festlegen eines Befehlstimeouts hat keine Auswirkungen, und der zurückgegebene Wert ist immer 0 (null).

Beispiel

Im folgenden Beispiel werden mithilfe der ExecuteReader-Methode von OracleCommand sowie mit OracleDataReader und OracleConnection Zeilen aus einer Tabelle ausgewählt.

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT EmpNo, DeptNo FROM Scott.Emp"
    Using connection As New OracleConnection(connectionString)
        Dim command As New OracleCommand(queryString, connection)
        connection.Open()
        Dim reader As OracleDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(reader.GetInt32(0) & ", " _
                   & reader.GetInt32(1))
            End While
        Finally
            ' always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT EmpNo, DeptNo FROM Scott.Emp";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        OracleCommand command = new OracleCommand(queryString, connection);
        connection.Open();
        OracleDataReader reader = command.ExecuteReader();
        try
        {
            while (reader.Read())
            {
                Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetInt32(1));
            }
        }
        finally
        {
            // always call Close when done reading.
            reader.Close();
        }
    }
}

Vererbungshierarchie

System.Object
   System.MarshalByRefObject
     System.ComponentModel.Component
       System.Data.Common.DbCommand
        System.Data.OracleClient.OracleCommand

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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-Member
System.Data.OracleClient-Namespace

Weitere Ressourcen

Arbeiten mit Befehlen