OracleCommand Klasa

Definicja

Przestroga

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

Reprezentuje instrukcję SQL lub procedurę składowaną do wykonania względem bazy danych. Klasa ta nie może być dziedziczona.

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 użyto ExecuteReader metody OracleCommand, wraz z elementami OracleDataReader i OracleConnection, aby wybrać wiersze z tabeli.

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łej wersji .NET Framework. Aby uzyskać więcej informacji, zobacz Oracle i ADO.NET.

Klasa OracleCommand udostępnia następujące metody wykonywania poleceń względem źródła danych:

Element Opis
ExecuteReader Wykonuje polecenia zwracające wiersze.
ExecuteOracleNonQuery Wykonuje instrukcję SQL względem elementu Connection i zwraca liczbę wierszy, których dotyczy problem.
ExecuteNonQuery Wykonuje polecenia, takie jak instrukcje SQL INSERT, DELETE, UPDATE i SET.
ExecuteScalar Pobiera pojedynczą wartość (na przykład wartość agregowaną) z bazy danych jako typ danych .NET Framework.
ExecuteOracleScalar Pobiera pojedynczą wartość (na przykład wartość agregowaną) z bazy danych jako typ danych specyficzny dla oracle.

Można zresetować CommandText właściwość i ponownie użyć OracleCommand obiektu.

Jeśli wykonanie polecenia spowoduje krytyczny wynik OracleException, OracleConnection może zostać zamknięty. Jednak użytkownik może ponownie otworzyć połączenie i kontynuować.

Uwaga

W przeciwieństwie do obiektu Command w innych dostawcach danych .NET Framework (SQL Server, OLE DB i ODBC), OracleCommand obiekt nie obsługuje CommandTimeout właściwości. Ustawienie limitu czasu polecenia nie ma wpływu, a zwracana wartość jest zawsze zero.

Konstruktory

OracleCommand()

Inicjuje nowe wystąpienie klasy OracleCommand.

OracleCommand(String)

Inicjuje OracleCommand nowe wystąpienie klasy z tekstem zapytania.

OracleCommand(String, OracleConnection)

Inicjuje nowe wystąpienie OracleCommand klasy z tekstem zapytania i obiektem OracleConnection .

OracleCommand(String, OracleConnection, OracleTransaction)

Inicjuje nowe wystąpienie OracleCommand klasy z tekstem zapytania, obiektem OracleConnection i elementem OracleTransaction.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
CommandText

Pobiera lub ustawia instrukcję SQL lub procedurę składowaną do wykonania względem bazy danych.

CommandTimeout

Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania polecenia i wygenerowaniem błędu.

CommandType

Pobiera lub ustawia wartość wskazującą sposób CommandText interpretowania właściwości.

Connection

Pobiera lub ustawia OracleConnection wartość używaną przez to wystąpienie klasy OracleCommand.

Container

Pobiera element IContainer zawierający element Component.

(Odziedziczone po Component)
DbConnection

Pobiera lub ustawia wartość używaną DbConnection przez ten DbCommandelement .

(Odziedziczone po DbCommand)
DbParameterCollection

Pobiera kolekcję DbParameter obiektów.

(Odziedziczone po DbCommand)
DbTransaction

Pobiera lub ustawia DbTransaction obiekt, w którym jest wykonywany ten DbCommand obiekt.

(Odziedziczone po DbCommand)
DesignMode

Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania.

(Odziedziczone po Component)
DesignTimeVisible

Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w niestandardowej kontrolce interfejsu.

Events

Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu .

(Odziedziczone po Component)
Parameters

Pobiera klasę OracleParameterCollection.

Site

Pobiera lub ustawia ISite element .Component

(Odziedziczone po Component)
Transaction

Pobiera lub ustawia OracleTransaction element, w którym OracleCommand są wykonywane.

UpdatedRowSource

Pobiera lub ustawia wartość określającą sposób Update zastosowania wyników polecenia metody do elementu DataRow.

Metody

Cancel()

Próbuje anulować wykonywanie elementu OracleCommand.

Clone()

Tworzy kopię tego OracleCommand obiektu.

CreateDbParameter()

Tworzy nowe wystąpienie DbParameter obiektu.

(Odziedziczone po DbCommand)
CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
CreateParameter()

Tworzy nowe wystąpienie OracleParameter obiektu.

Dispose()

Zwalnia wszelkie zasoby używane przez element Component.

(Odziedziczone po Component)
Dispose()

Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.

(Odziedziczone po DbCommand)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbCommand i opcjonalnie zwalnia zasoby zarządzane.

(Odziedziczone po DbCommand)
DisposeAsync()

Asynchronicznie dysponuje obiekt polecenia.

(Odziedziczone po DbCommand)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)

Wykonuje polecenie względem połączenia, zwracając DbDataReader element, który może służyć do uzyskiwania dostępu do wyników.

(Odziedziczone po DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Dostawcy powinni zaimplementować tę metodę w celu zapewnienia nie domyślnej implementacji ExecuteReader przeciążeń.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteReader() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteReader będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku zadania.

Ta metoda akceptuje token anulowania, który może służyć do żądania wcześniejszego anulowania operacji. Implementacje mogą ignorować to żądanie.

(Odziedziczone po DbCommand)
ExecuteNonQuery()

Wykonuje instrukcję SQL względem Connection obiektu i zwraca liczbę wierszy, których dotyczy problem.

ExecuteNonQueryAsync()

Asynchroniczna wersja programu ExecuteNonQuery(), która wykonuje polecenie względem obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem.

ExecuteNonQueryAsync(CancellationToken) Wywołuje element CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Jest to asynchroniczna wersja programu ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteNonQuery() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłoszone przez ExecuteNonQuery() program będą przekazywane za pośrednictwem zwróconej właściwości Wyjątki zadania.

Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

(Odziedziczone po DbCommand)
ExecuteOracleNonQuery(OracleString)

Wykonuje instrukcję SQL względem Connection obiektu i zwraca liczbę wierszy, których dotyczy problem.

ExecuteOracleScalar()

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie jako typ danych specyficzny dla oracle. Dodatkowe kolumny lub wiersze są ignorowane.

ExecuteReader()

Wysyła element CommandText do elementu Connection i tworzy element OracleDataReader.

ExecuteReader(CommandBehavior)

Wysyła element CommandText do elementu Connectioni tworzy obiekt OracleDataReader przy użyciu jednej z CommandBehavior wartości.

ExecuteReaderAsync()

Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Wywołuje element CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Wywołuje polecenie .

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja programu ExecuteReader, która wykonuje polecenie względem połączenia, zwracając element DbDataReader , który może służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Wywołuje polecenie .

(Odziedziczone po DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Wywołuje polecenie .

(Odziedziczone po DbCommand)
ExecuteScalar()

Wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie jako typ danych platformy .NET. Dodatkowe kolumny lub wiersze są ignorowane.

ExecuteScalarAsync()

Asynchroniczna wersja ExecuteScalar()elementu , która wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.

ExecuteScalarAsync(CancellationToken) Wywołuje element CancellationToken.None.

(Odziedziczone po DbCommand)
ExecuteScalarAsync(CancellationToken)

Jest to asynchroniczna wersja programu ExecuteScalar(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje metodę synchroniczną ExecuteScalar() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteScalar będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku zadania.

Nie należy wywoływać innych metod i właściwości DbCommand obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

(Odziedziczone po DbCommand)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container.

(Odziedziczone po Component)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu.

(Odziedziczone po MarshalByRefObject)
Prepare()

Tworzy przygotowaną (lub skompilowana) wersję polecenia w źródle danych.

PrepareAsync(CancellationToken)

Asynchronicznie tworzy przygotowaną (lub skompilowana) wersję polecenia w źródle danych.

(Odziedziczone po DbCommand)
ResetCommandTimeout()

Resetuje CommandTimeout właściwość do wartości domyślnej.

ToString()

Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody .

(Odziedziczone po Component)

Jawne implementacje interfejsu

IDbCommand.Connection

Pobiera lub ustawia IDbConnection wartość używaną przez to wystąpienie klasy IDbCommand.

(Odziedziczone po DbCommand)
IDbCommand.CreateParameter()

Tworzy nowe wystąpienie IDbDataParameter obiektu.

IDbCommand.CreateParameter()

Tworzy nowe wystąpienie IDbDataParameter obiektu.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader()

Wykonuje element CommandText względem elementu Connection i tworzy element IDataReader.

IDbCommand.ExecuteReader()

Wykonuje element CommandText względem elementu Connection i tworzy element IDataReader.

(Odziedziczone po DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje element CommandText względem elementu Connectioni tworzy obiekt IDataReader przy użyciu jednej z CommandBehavior wartości.

IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje element CommandText względem elementu Connectioni tworzy element IDataReader przy użyciu jednej z CommandBehavior wartości.

(Odziedziczone po DbCommand)
IDbCommand.Parameters

Pobiera klasę IDataParameterCollection.

(Odziedziczone po DbCommand)
IDbCommand.Transaction

Pobiera lub ustawia DbTransaction obiekt, w którym jest wykonywany ten DbCommand obiekt.

(Odziedziczone po DbCommand)

Dotyczy

Zobacz też