OracleCommand Klasa

Definicja

Przestroga

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

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
[<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 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 , a razem 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.

OracleCommandKlasa zawiera 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ć CommandText Właściwość i ponownie użyć OracleCommand obiektu.You can reset the CommandText property and reuse the OracleCommand object.

Jeśli wykonanie polecenia spowoduje krytyczne OracleException , 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 dostawcach danych .NET Framework (SQL Server, OLE DB i ODBC) obiekt nie OracleCommand obsługuje CommandTimeout właściwości.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 OracleCommand klasy z tekstem zapytania.Initializes a new instance of the OracleCommand class with the text of the query.

OracleCommand(String, OracleConnection)

Inicjuje nowe wystąpienie OracleCommand klasy z tekstem zapytania i OracleConnection obiektu.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 OracleCommand klasy z tekstem zapytania, OracleConnection obiektu 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 CommandText interpretacji właściwości.Gets or sets a value indicating how the CommandText property is interpreted.

Connection

Pobiera lub ustawia OracleConnection używane przez to wystąpienie elementu 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żywane przez nią 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ę DbParameter obiektów.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 ramach którego jest DbCommand wykonywany ten obiekt.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 aktualnie 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 elementu 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 wartość ISite Component .Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Transaction

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

UpdatedRowSource

Pobiera lub ustawia wartość określającą, jak Update Metoda 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ć wykonanie OracleCommand .Attempts to cancel the execution of an OracleCommand.

Clone()

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

CreateDbParameter()

Gdy jest zastępowany w klasie pochodnej, tworzy nowe wystąpienie DbParameter obiektu.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 OracleParameter obiektu.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()

Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

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

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

(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ć implementację niedomyślną dla ExecuteReader przeciążenia.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Implementacja domyślna wywołuje metodę synchroniczną ExecuteReader() i zwraca ukończone zadanie, 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 programu 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 metodę synchroniczną ExecuteNonQuery() i zwraca ukończone zadanie, 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() program będą przekazywane przez zwracaną 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 DbCommand obiektu do momentu zakończenia zwracanego zadania.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 Connection i kompiluje OracleDataReader przy użyciu jednej z CommandBehavior wartości.Sends the CommandText to the Connection, and builds an OracleDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Asynchroniczna wersja ExecuteReader , która wykonuje polecenie 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 polecenie 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 polecenie 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 zwracanym przez zapytanie jako typ danych .NET.Executes the query, and returns the first column of the first row in the result set returned by the query as a .NET 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 programu 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 metodę synchroniczną ExecuteScalar() i zwraca ukończone zadanie, 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 DbCommand obiektu do momentu zakończenia zwracanego zadania.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()
Nieaktualne.

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 przez Container .Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

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 elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.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 CommandTimeout Właściwość do wartości domyślnej.Resets the CommandTimeout property to the default value.

ToString()

Zwraca wartość String zawierającą 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 Dispose() metody.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żywane przez to wystąpienie elementu IDbCommand .Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Odziedziczone po DbCommand)
IDbCommand.CreateParameter()

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

IDbCommand.CreateParameter()

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

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader()

Wykonuje w CommandText odniesieniu do Connection i kompiluje IDataReader .Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader()

Wykonuje w CommandText odniesieniu do Connection i kompiluje IDataReader .Executes the CommandText against the Connection and builds an IDataReader.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

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

IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje CommandText Connection polecenie względem i kompiluje IDataReader przy użyciu jednej z CommandBehavior wartości.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 wartość, DbTransaction w ramach której jest DbCommand wykonywany ten obiekt.Gets or sets the DbTransaction within which this DbCommand object executes.

(Odziedziczone po DbCommand)

Dotyczy