OracleCommand Klasse

Definition

Namespace:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Achtung

OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

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

public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable

[System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommand : System.Data.Common.DbCommand, ICloneable

[<System.Obsolete("OracleCommand has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable

Vererbung

Object

MarshalByRefObject

Component

DbCommand

OracleCommand

Attribute

ObsoleteAttribute

Implementiert

ICloneable

Beispiele

Im folgenden Beispiel wird die ExecuteReader -Methode von OracleCommand, zusammen mit OracleDataReader und OracleConnectionverwendet, um Zeilen aus einer Tabelle auszuwählen.

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();
        }
    }
}

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

Hinweise

Dieser Typ ist veraltet und wird in einer zukünftigen Version des .NET Framework entfernt. Weitere Informationen finden Sie unter Oracle und ADO.NET.

Die OracleCommand -Klasse stellt die folgenden 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 SQL INSERT-, DELETE-, UPDATE- und SET-Anweisungen 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-spezifischen Datentyp ab.

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

Wenn die Ausführung des Befehls zu einem schwerwiegenden OracleExceptionErgebnis führt, kann die OracleConnection geschlossen werden. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.

Hinweis

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

Konstruktoren

OracleCommand()	Veraltet. Initialisiert eine neue Instanz des OracleCommand.
OracleCommand(String)	Veraltet. Initialisiert eine neue Instanz der OracleCommand-Klasse mit dem Text der Abfrage.
OracleCommand(String, OracleConnection)	Veraltet. Initialisiert eine neue Instanz der OracleCommand-Klasse mit dem Text der Abfrage und ein OracleConnection-Objekt.
OracleCommand(String, OracleConnection, OracleTransaction)	Veraltet. Initialisiert eine neue Instanz der OracleCommand-Klasse mit dem Text der Abfrage, ein OracleConnection-Objekt und eine OracleTransaction.

Eigenschaften

CanRaiseEvents	Veraltet. Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann. (Geerbt von Component)
CommandText	Veraltet. Ruft die SQL-Anweisung oder gespeicherte Prozedur ab, die für die Datenbank ausgeführt werden soll, oder legt diese fest.
CommandTimeout	Veraltet. Ruft die Zeit (in Sekunden) ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest.
CommandType	Veraltet. Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen fest.
Connection	Veraltet. Ruft die OracleConnection ab, die von dieser Instanz des OracleCommand verwendet wird, oder legt diese fest.
Container	Veraltet. Ruft die IContainer ab, die in der Component enthalten ist. (Geerbt von Component)
DbConnection	Veraltet. Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest. (Geerbt von DbCommand)
DbParameterCollection	Veraltet. Ruft die Auflistung von DbParameter-Objekten ab. (Geerbt von DbCommand)
DbTransaction	Veraltet. Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest. (Geerbt von DbCommand)
DesignMode	Veraltet. Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet. (Geerbt von Component)
DesignTimeVisible	Veraltet. Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Schnittstellensteuerelement sichtbar sein soll, oder legt diesen fest.
Events	Veraltet. Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind. (Geerbt von Component)
Parameters	Veraltet. Ruft das OracleParameterCollection ab.
Site	Veraltet. Ruft den ISite von Component ab oder legt ihn fest. (Geerbt von Component)
Transaction	Veraltet. Ruft die OracleTransaction ab, in der der OracleCommand ausgeführt wird, bzw. legt diese fest.
UpdatedRowSource	Veraltet. Ruft einen Wert ab, der angibt, wie die Update-Methode Befehlsergebnisse auf die DataRow anwendet, oder legt diesen fest.

Methoden

Cancel()	Veraltet. Versucht die Ausführung eines OracleCommand abzubrechen.
Clone()	Veraltet. Erstellt eine Kopie dieses OracleCommand-Objekts.
CreateDbParameter()	Veraltet. Erstellt eine neue Instanz eines DbParameter-Objekts. (Geerbt von DbCommand)
CreateObjRef(Type)	Veraltet. Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
CreateParameter()	Veraltet. Erstellt eine neue Instanz eines OracleParameter -Objekts.
Dispose()	Veraltet. Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Geerbt von DbCommand)
Dispose(Boolean)	Veraltet. Gibt die von DbCommand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von DbCommand)
DisposeAsync()	Veraltet. Stellt das Befehlsobjekt asynchron bereit. (Geerbt von DbCommand)
Equals(Object)	Veraltet. Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Veraltet. Führt den Befehl für seine Verbindung aus und gibt einen zurück DbDataReader , der für den Zugriff auf die Ergebnisse verwendet werden kann. (Geerbt von DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Veraltet. Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader-Überladungen bereitzustellen. Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern. Implementierungen können diese Anforderung ignorieren. (Geerbt von DbCommand)
ExecuteNonQuery()	Veraltet. Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteNonQueryAsync()	Veraltet. Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für sein Verbindungsobjekt ausführt und die Anzahl der betroffenen Zeilen zurückgibt. Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Veraltet. Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
ExecuteOracleNonQuery(OracleString)	Veraltet. Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteOracleScalar()	Veraltet. Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage als Oracle-Datentyp zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.
ExecuteReader()	Veraltet. Sendet den CommandText an die Connection und erstellt einen OracleDataReader.
ExecuteReader(CommandBehavior)	Veraltet. Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OracleDataReader.
ExecuteReaderAsync()	Veraltet. Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) mit CancellationToken.None auf. (Geerbt von DbCommand)
ExecuteReaderAsync(CancellationToken)	Veraltet. Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf. (Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior)	Veraltet. Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf. (Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Veraltet. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf. (Geerbt von DbCommand)
ExecuteScalar()	Veraltet. Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage als .NET-Datentyp zurückgegeben wird. Zusätzliche Spalten oder Zeilen werden ignoriert.
ExecuteScalarAsync()	Veraltet. Eine asynchrone Version von ExecuteScalar(), die den Befehl ausführt und die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurückgibt. Alle anderen Spalten, Zeilen und Resultsets werden ignoriert. Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf. (Geerbt von DbCommand)
ExecuteScalarAsync(CancellationToken)	Veraltet. Dies ist die asynchrone Version von ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt. Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist. (Geerbt von DbCommand)
GetHashCode()	Veraltet. Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Veraltet. Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt. (Geerbt von Component)
GetType()	Veraltet. Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Veraltet. Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Veraltet. Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
Prepare()	Veraltet. Erstellt eine vorbereitete (oder kompilierte) Version des Befehls an der Datenquelle.
PrepareAsync(CancellationToken)	Veraltet. Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle. (Geerbt von DbCommand)
ResetCommandTimeout()	Veraltet. Setzt die CommandTimeout-Eigenschaft auf den Standardwert zurück.
ToString()	Veraltet. Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden. (Geerbt von Component)

Ereignisse

Disposed

Veraltet. Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird. (Geerbt von Component)

Explizite Schnittstellenimplementierungen

IDbCommand.Connection	Veraltet. Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest. (Geerbt von DbCommand)
IDbCommand.CreateParameter()	Veraltet. Erstellt eine neue Instanz eines IDbDataParameter -Objekts. (Geerbt von DbCommand)
IDbCommand.ExecuteReader()	Veraltet. Führt den CommandText für die Connection aus und erstellt einen IDataReader. (Geerbt von DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Veraltet. Führt CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior. (Geerbt von DbCommand)
IDbCommand.Parameters	Veraltet. Ruft das IDataParameterCollection ab. (Geerbt von DbCommand)
IDbCommand.Transaction	Veraltet. Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest. (Geerbt von DbCommand)

Weitere Informationen

• Arbeiten mit Befehlen