OracleCommand OracleCommand OracleCommand OracleCommand Class

Definition

Warnung

Diese API ist jetzt veraltet.

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die für eine Datenbank ausgeführt werden soll.Represents an SQL statement or stored procedure to execute against a database. Diese Klasse kann nicht vererbt werden.This class cannot be inherited.

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
type OracleCommand = class
    inherit DbCommand
    interface ICloneable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable
Vererbung
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird die ExecuteReader -Methode OracleCommandvon zusammen mit OracleDataReader und OracleConnectionverwendet, um Zeilen aus einer Tabelle auszuwählen.The following example uses the ExecuteReader method of OracleCommand, along with OracleDataReader and OracleConnection, to select rows from a table.

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.This type is deprecated and will be removed in a future version of the .NET Framework. Weitere Informationen finden Sie unter Oracle und ADO.net.For more information, see Oracle and ADO.NET.

Die OracleCommand -Klasse stellt die folgenden Methoden zum Ausführen von Befehlen für eine Datenquelle bereit:The OracleCommand class provides the following methods for executing commands against a data source:

ElementItem BeschreibungDescription
ExecuteReader Führt Befehle aus, die Zeilen zurückgeben.Executes commands that return rows.
ExecuteOracleNonQuery Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection and returns the number of rows affected.
ExecuteNonQuery Führt Befehle wie INSERT-, DELETE-, Update-und SET-Anweisungen in SQL aus.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Ruft einen einzelnen Wert (z. b. einen Aggregatwert) aus einer Datenbank als .NET Framework Datentyp ab.Retrieves a single value (for example, an aggregate value) from a database as a .NET Framework data type.
ExecuteOracleScalar Ruft einen einzelnen Wert (z. b. einen Aggregatwert) aus einer Datenbank als Oracle-spezifischen Datentyp ab.Retrieves a single value (for example, an aggregate value) from a database as an Oracle-specific data type.

Sie können die CommandText -Eigenschaft zurücksetzen und OracleCommand das-Objekt wieder verwenden.You can reset the CommandText property and reuse the OracleCommand object.

Wenn die Ausführung des Befehls zu einem OracleExceptionschwerwiegenden Ergebnis führt OracleConnection , wird möglicherweise geschlossen.If execution of the command results in a fatal OracleException, the OracleConnection may close. Die Benutzer können die Verbindung aber erneut öffnen und fortfahren.However, the user can reopen the connection and continue.

Hinweis

Anders als das Command -Objekt in den anderen .NET Framework-Datenanbietern (SQL Server, OLE DB und ODBC) OracleCommand unterstützt CommandTimeout das-Objekt keine-Eigenschaft.Unlike the Command object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), the OracleCommand object does not support a CommandTimeout property. Das Festlegen eines Befehls Timeouts hat keine Auswirkung, und der zurückgegebene Wert ist immer 0 (null).Setting a command timeout has no effect and the value returned is always zero.

Konstruktoren

OracleCommand() OracleCommand() OracleCommand() OracleCommand()

Initialisiert eine neue Instanz des OracleCommand.Initializes a new instance of the OracleCommand.

OracleCommand(String) OracleCommand(String) OracleCommand(String) OracleCommand(String)

Initialisiert eine neue Instanz der OracleCommand-Klasse mit dem Text der Abfrage.Initializes a new instance of the OracleCommand class with the text of the query.

OracleCommand(String, OracleConnection) OracleCommand(String, OracleConnection) OracleCommand(String, OracleConnection) OracleCommand(String, OracleConnection)

Initialisiert eine neue Instanz der OracleCommand-Klasse mit dem Text der Abfrage und ein OracleConnection-Objekt.Initializes a new instance of the OracleCommand class with the text of the query and an OracleConnection object.

OracleCommand(String, OracleConnection, OracleTransaction) OracleCommand(String, OracleConnection, OracleTransaction) OracleCommand(String, OracleConnection, OracleTransaction) OracleCommand(String, OracleConnection, OracleTransaction)

Initialisiert eine neue Instanz der OracleCommand-Klasse mit dem Text der Abfrage, ein OracleConnection-Objekt und eine OracleTransaction.Initializes a new instance of the OracleCommand class with the text of the query, an OracleConnection object, and an OracleTransaction.

Eigenschaften

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CommandText CommandText CommandText CommandText

Ruft die SQL-Anweisung oder gespeicherte Prozedur ab, die für die Datenbank ausgeführt werden soll, oder legt diese fest.Gets or sets the SQL statement or stored procedure to execute against the database.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Ruft die Zeit ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest.Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen fest.Gets or sets a value indicating how the CommandText property is interpreted.

Connection Connection Connection Connection

Ruft die OracleConnection ab, die von dieser Instanz des OracleCommand verwendet wird, oder legt diese fest.Gets or sets the OracleConnection used by this instance of the OracleCommand.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible DesignTimeVisible

Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Schnittstellensteuerelement sichtbar sein soll, oder legt diesen fest.Gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Parameters Parameters Parameters Parameters

Ruft das OracleParameterCollection ab.Gets the OracleParameterCollection.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
Transaction Transaction Transaction Transaction

Ruft die OracleTransaction ab, in der der OracleCommand ausgeführt wird, bzw. legt diese fest.Gets or sets the OracleTransaction within which the OracleCommand executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Ruft einen Wert ab, der angibt, wie die Update-Methode Befehlsergebnisse auf die DataRow anwendet, oder legt diesen fest.Gets or sets a value that specifies how the Update method should apply command results to the DataRow.

Methoden

Cancel() Cancel() Cancel() Cancel()

Versucht die Ausführung eines OracleCommand abzubrechen.Attempts to cancel the execution of an OracleCommand.

Clone() Clone() Clone() Clone()

Erstellt eine Kopie dieses OracleCommand-Objekts.Creates a copy of this OracleCommand object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

Erstellt eine neue Instanz eines OracleParameter-Objekts.Creates a new instance of an OracleParameter object.

Dispose() Dispose() Dispose() Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteOracleNonQuery(OracleString) ExecuteOracleNonQuery(OracleString) ExecuteOracleNonQuery(OracleString) ExecuteOracleNonQuery(OracleString)

Führt eine SQL-Anweisung für die Connection aus und gibt die Anzahl der betroffenen Zeilen zurück.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteOracleScalar() ExecuteOracleScalar() ExecuteOracleScalar() ExecuteOracleScalar()

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.Executes the query, and returns the first column of the first row in the result set returned by the query as an Oracle-specific data type. Zusätzliche Spalten oder Zeilen werden ignoriert.Extra columns or rows are ignored.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Sendet den CommandText an die Connection und erstellt einen OracleDataReader.Sends the CommandText to the Connection and builds an OracleDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Sendet den CommandText an die Connection und erstellt mithilfe eines der CommandBehavior-Werte einen OracleDataReader.Sends the CommandText to the Connection, and builds an OracleDataReader using one of the CommandBehavior values.

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage als .NET Framework-Datentyp zurückgegeben wird.Executes the query, and returns the first column of the first row in the result set returned by the query as a .NET Framework data type. Zusätzliche Spalten oder Zeilen werden ignoriert.Extra columns or rows are ignored.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls an der Datenquelle.Creates a prepared (or compiled) version of the command at the data source.

ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout()

Setzt die CommandTimeout-Eigenschaft auf den Standardwert zurück.Resets the CommandTimeout property to the default value.

ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)

Explizite Schnittstellenimplementierungen

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter-Objekts.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

Führt den CommandText für die Connection aus und erstellt einen IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

Führt den CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader by using one of the CommandBehavior values.

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch