OracleCommand Klasa

Definicja

Ostrzeżenie

Ten interfejs API jest teraz przestarzały.

Reprezentuje instrukcję SQL lub procedurę składowaną, która ma zostać wykonana względem bazy danych.Represents an SQL statement or stored procedure to execute against a database. Klasa ta nie może być dziedziczona.This class cannot be inherited.

public ref class OracleCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public ref class OracleCommand sealed : System::Data::Common::DbCommand, ICloneable
public sealed class OracleCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OracleCommand : 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 Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OracleCommand = class
    inherit DbCommand
    interface ICloneable
Public NotInheritable Class OracleCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OracleCommand
Inherits DbCommand
Implements ICloneable
Dziedziczenie
Dziedziczenie
Atrybuty
Implementuje

Przykłady

W poniższym przykładzie zastosowano ExecuteReader metodę OracleCommand, wraz z OracleDataReader i OracleConnection, aby wybrać wiersze z tabeli.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

Uwagi

Ten typ jest przestarzały i zostanie usunięty w przyszłych wersjach .NET Framework.This type is deprecated and will be removed in a future version of the .NET Framework. Aby uzyskać więcej informacji, zobacz artykuł Oracle i ADO.NET.For more information, see Oracle and ADO.NET.

Klasa OracleCommand udostępnia następujące metody wykonywania poleceń względem źródła danych:The OracleCommand class provides the following methods for executing commands against a data source:

ElementItem OpisDescription
ExecuteReader Wykonuje polecenia, które zwracają wiersze.Executes commands that return rows.
ExecuteOracleNonQuery Wykonuje instrukcję SQL względem Connection i zwraca liczbę wierszy, których to dotyczy.Executes an SQL statement against the Connection and returns the number of rows affected.
ExecuteNonQuery Wykonuje polecenia, takie jak instrukcje SQL INSERT, DELETE, UPDATE i SET.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Pobiera pojedynczą wartość (na przykład wartość zagregowaną) z bazy danych jako typ danych .NET Framework.Retrieves a single value (for example, an aggregate value) from a database as a .NET Framework data type.
ExecuteOracleScalar Pobiera pojedynczą wartość (na przykład wartość zagregowaną) z bazy danych jako typ danych specyficznych dla platformy Oracle.Retrieves a single value (for example, an aggregate value) from a database as an Oracle-specific data type.

Możesz zresetować Właściwość CommandText i ponownie użyć obiektu OracleCommand.You can reset the CommandText property and reuse the OracleCommand object.

Jeśli wykonanie polecenia powoduje OracleExceptionkrytyczne, OracleConnection może zostać zamknięte.If execution of the command results in a fatal OracleException, the OracleConnection may close. Użytkownik może jednak ponownie otworzyć połączenie i kontynuować pracę.However, the user can reopen the connection and continue.

Uwaga

W przeciwieństwie do obiektu polecenia w innych .NET Framework dostawców danych (SQL Server, OLE DB i ODBC) obiekt OracleCommand nie obsługuje właściwości CommandTimeout.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. Ustawienie limitu czasu polecenia nie ma wpływu, a zwracana wartość jest zawsze równa zero.Setting a command timeout has no effect and the value returned is always zero.

Konstruktory

OracleCommand()

Inicjuje nowe wystąpienie klasy OracleCommand.Initializes a new instance of the OracleCommand.

OracleCommand(String)

Inicjuje nowe wystąpienie klasy OracleCommand z tekstem zapytania.Initializes a new instance of the OracleCommand class with the text of the query.

OracleCommand(String, OracleConnection)

Inicjuje nowe wystąpienie klasy OracleCommand z tekstem zapytania i obiektem OracleConnection.Initializes a new instance of the OracleCommand class with the text of the query and an OracleConnection object.

OracleCommand(String, OracleConnection, OracleTransaction)

Inicjuje nowe wystąpienie klasy OracleCommand z tekstem zapytania, obiektem OracleConnection i OracleTransaction.Initializes a new instance of the OracleCommand class with the text of the query, an OracleConnection object, and an OracleTransaction.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
CommandText

Pobiera lub ustawia instrukcję SQL lub procedurę przechowywaną do wykonania w bazie danych.Gets or sets the SQL statement or stored procedure to execute against the database.

CommandTimeout

Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania polecenia i wygenerowaniem błędu.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Pobiera lub ustawia wartość wskazującą sposób interpretacji właściwości CommandText.Gets or sets a value indicating how the CommandText property is interpreted.

Connection

Pobiera lub ustawia OracleConnection używany przez to wystąpienie OracleCommand.Gets or sets the OracleConnection used by this instance of the OracleCommand.

Container

Pobiera IContainer, który zawiera Component.Gets the IContainer that contains the Component.

(Odziedziczone po Component)
DbConnection

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia DbConnection używany przez ten DbCommand.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Odziedziczone po DbCommand)
DbParameterCollection

Gdy jest zastępowany w klasie pochodnej, pobiera kolekcję obiektów DbParameter.When overridden in a derived class, gets the collection of DbParameter objects.

(Odziedziczone po DbCommand)
DbTransaction

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia DbTransaction, w których jest wykonywany ten obiekt DbCommand.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(Odziedziczone po DbCommand)
DesignMode

Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
DesignTimeVisible

Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanym formancie interfejsu.Gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego Component.Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
Parameters

Pobiera klasę OracleParameterCollection.Gets the OracleParameterCollection.

Site

Pobiera lub ustawia ISite Component.Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Transaction

Pobiera lub ustawia OracleTransaction, w ramach którego OracleCommand wykonuje.Gets or sets the OracleTransaction within which the OracleCommand executes.

UpdatedRowSource

Pobiera lub ustawia wartość określającą sposób, w jaki Metoda Update powinna stosować wyniki polecenia do DataRow.Gets or sets a value that specifies how the Update method should apply command results to the DataRow.

Metody

Cancel()

Próbuje anulować wykonywanie OracleCommand.Attempts to cancel the execution of an OracleCommand.

Clone()

Tworzy kopię tego obiektu OracleCommand.Creates a copy of this OracleCommand object.

CreateDbParameter()

Gdy jest zastępowany w klasie pochodnej, tworzy nowe wystąpienie obiektu DbParameter.When overridden in a derived class, creates a new instance of a DbParameter object.

(Odziedziczone po DbCommand)
CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
CreateParameter()

Tworzy nowe wystąpienie obiektu OracleParameter.Creates a new instance of an OracleParameter object.

Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose() (Odziedziczone po DbCommand)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
Dispose(Boolean) (Odziedziczone po DbCommand)
DisposeAsync()

Asynchronicznie nakłada obiekt polecenia.Asynchronously diposes the command object.

(Odziedziczone po DbCommand)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)

Gdy jest zastępowany w klasie pochodnej, wykonuje tekst polecenia względem połączenia.When overridden in a derived class, executes the command text against the connection.

(Odziedziczone po DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Dostawcy powinni zaimplementować tę metodę, aby zapewnić niedomyślną implementację przeciążeń ExecuteReader.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Implementacja domyślna wywołuje synchroniczną metodę ExecuteReader() i zwraca zadanie zakończone, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteReader będą przekazywane przy użyciu zwróconej właściwości wyjątku zadania.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Ta metoda akceptuje token anulowania, którego można użyć do żądania wcześniejszego anulowania operacji.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementacje mogą zignorować to żądanie.Implementations may ignore this request.

(Odziedziczone po DbCommand)
ExecuteNonQuery()

Wykonuje instrukcję SQL względem Connection i zwraca liczbę wierszy, których to dotyczy.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteNonQueryAsync()

Asynchroniczna wersja ExecuteNonQuery(), która wykonuje instrukcję SQL względem obiektu połączenia.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Wywołuje ExecuteNonQueryAsync(CancellationToken) z CancellationToken. None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Jest to asynchroniczna wersja ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania może być opcjonalnie ignorowany.The cancellation token may optionally be ignored.

Implementacja domyślna wywołuje synchroniczną metodę ExecuteNonQuery() i zwraca zadanie zakończone, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteNonQuery() będą przekazywane przez zwróconą Właściwość wyjątku zadania.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości obiektu DbCommand, dopóki nie zakończy się zwrócone zadanie.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Odziedziczone po DbCommand)
ExecuteOracleNonQuery(OracleString)

Wykonuje instrukcję SQL względem Connection i zwraca liczbę wierszy, których to dotyczy.Executes an SQL statement against the Connection and returns the number of rows affected.

ExecuteOracleScalar()

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie jako typ danych specyficznych dla platformy Oracle.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. Dodatkowe kolumny lub wiersze są ignorowane.Extra columns or rows are ignored.

ExecuteReader()

Wysyła CommandText do Connection i kompiluje OracleDataReader.Sends the CommandText to the Connection and builds an OracleDataReader.

ExecuteReader(CommandBehavior)

Wysyła CommandText do Connectioni kompiluje OracleDataReader przy użyciu jednej z wartości CommandBehavior.Sends the CommandText to the Connection, and builds an OracleDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Asynchroniczna wersja ExecuteReader, która wykonuje CommandText względem Connection i zwraca DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) z CancellationToken. None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja ExecuteReader, która wykonuje CommandText względem Connection i zwraca DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Ta metoda propaguje powiadomienie, że operacje powinny być anulowane.This method propagates a notification that operations should be canceled.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja ExecuteReader, która wykonuje CommandText względem Connection i zwraca DbDataReader.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Odziedziczone po DbCommand)
ExecuteScalar()

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie jako typ danych .NET Framework.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. Dodatkowe kolumny lub wiersze są ignorowane.Extra columns or rows are ignored.

ExecuteScalarAsync()

Asynchroniczna wersja ExecuteScalar(), która wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Wszystkie inne kolumny i wiersze są ignorowane.All other columns and rows are ignored.

Wywołuje ExecuteScalarAsync(CancellationToken) z CancellationToken. None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteScalarAsync(CancellationToken)

Jest to asynchroniczna wersja ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania może być opcjonalnie ignorowany.The cancellation token may optionally be ignored.

Implementacja domyślna wywołuje synchroniczną metodę ExecuteScalar() i zwraca zadanie zakończone, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteScalar będą przekazywane przy użyciu zwróconej właściwości wyjątku zadania.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości obiektu DbCommand, dopóki nie zakończy się zwrócone zadanie.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Odziedziczone po DbCommand)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub Container.Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego obiektu MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
Prepare()

Tworzy przygotowaną (lub skompilowaną) wersję polecenia w źródle danych.Creates a prepared (or compiled) version of the command at the data source.

PrepareAsync(CancellationToken)

Asynchronicznie tworzy przygotowaną (lub skompilowaną) wersję polecenia w źródle danych.Asynchronously creates a prepared (or compiled) version of the command on the data source.

(Odziedziczone po DbCommand)
ResetCommandTimeout()

Resetuje właściwość CommandTimeout do wartości domyślnej.Resets the CommandTimeout property to the default value.

ToString()

Zwraca String zawierający nazwę Component, jeśli istnieje.Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie metody Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Jawne implementacje interfejsu

IDbCommand.Connection

Pobiera lub ustawia IDbConnection używany przez to wystąpienie IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Odziedziczone po DbCommand)
IDbCommand.CreateParameter()

Tworzy nowe wystąpienie obiektu IDbDataParameter.Creates a new instance of an IDbDataParameter object.

IDbCommand.CreateParameter()

Tworzy nowe wystąpienie obiektu IDbDataParameter.Creates a new instance of an IDbDataParameter object.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader()

Wykonuje CommandText z Connection i kompiluje IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader()

Wykonuje CommandText z Connection i kompiluje IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje CommandText z Connectioni kompiluje IDataReader przy użyciu jednej z wartości CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader by using one of the CommandBehavior values.

IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje CommandText z Connectioni kompiluje IDataReader przy użyciu jednej z wartości CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

(Odziedziczone po DbCommand)
IDbCommand.Parameters

Pobiera klasę IDataParameterCollection.Gets the IDataParameterCollection.

(Odziedziczone po DbCommand)
IDbCommand.Transaction

Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

(Odziedziczone po DbCommand)

Dotyczy

Zobacz też