OracleCommand Třída

Definice

Upozornění

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

Představuje příkaz SQL nebo uloženou proceduru, která se má provést proti databázi. Tato třída se nemůže dědit.

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
Dědičnost
Dědičnost
Atributy
Implementuje

Příklady

Následující příklad používá metodu ExecuteReaderOracleCommand, spolu s OracleDataReader a OracleConnection, k výběru řádků z tabulky.

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

Poznámky

Tento typ je zastaralý a v budoucí verzi rozhraní .NET Framework bude odebrán. Další informace najdete v tématu Oracle a ADO.NET.

Třída OracleCommand poskytuje následující metody pro spouštění příkazů se zdrojem dat:

Položka Popis
ExecuteReader Spustí příkazy, které vracejí řádky.
ExecuteOracleNonQuery Provede příkaz SQL proti Connection a vrátí počet ovlivněných řádků.
ExecuteNonQuery Spouští příkazy, jako jsou příkazy SQL INSERT, DELETE, UPDATE a SET.
ExecuteScalar Načte jednu hodnotu (například agregovanou hodnotu) z databáze jako datový typ rozhraní .NET Framework.
ExecuteOracleScalar Načte jednu hodnotu (například agregační hodnotu) z databáze jako datový typ specifický pro Oracle.

Vlastnost můžete resetovat CommandText a objekt znovu použít OracleCommand .

Pokud spuštění příkazu má za následek závažnou OracleException, může se OracleConnection zavřít. Uživatel ale může znovu otevřít připojení a pokračovat.

Poznámka

Na rozdíl od objektu Command v jiných zprostředkovatelích dat rozhraní .NET Framework (SQL Server, OLE DB a ODBC) OracleCommand objekt nepodporuje CommandTimeout vlastnost. Nastavení časového limitu příkazu nemá žádný vliv a vrácená hodnota je vždy nula.

Konstruktory

OracleCommand()
Zastaralé.

Inicializuje novou instanci objektu OracleCommand.

OracleCommand(String)
Zastaralé.

Inicializuje novou instanci OracleCommand třídy s textem dotazu.

OracleCommand(String, OracleConnection)
Zastaralé.

Inicializuje novou instanci OracleCommand třídy s textem dotazu a objektu OracleConnection .

OracleCommand(String, OracleConnection, OracleTransaction)
Zastaralé.

Inicializuje novou instanci OracleCommand třídy s textem dotazu, objektem OracleConnection a objektem OracleTransaction.

Vlastnosti

CanRaiseEvents
Zastaralé.

Získá hodnotu označující, zda komponenta může vyvolat událost.

(Zděděno od Component)
CommandText
Zastaralé.

Získá nebo nastaví sql příkaz nebo uložená procedura provést proti databázi.

CommandTimeout
Zastaralé.

Získá nebo nastaví čekací dobu (v sekundách) před ukončením pokusu o spuštění příkazu a generování chyby.

CommandType
Zastaralé.

Získá nebo nastaví hodnotu označující, jak CommandText je vlastnost interpretována.

Connection
Zastaralé.

Získá nebo nastaví OracleConnection používaná touto instancí objektu OracleCommand.

Container
Zastaralé.

Získá objekt IContainer , který obsahuje Component.

(Zděděno od Component)
DbConnection
Zastaralé.

Získá nebo nastaví DbConnection používaná tímto DbCommandobjektem .

(Zděděno od DbCommand)
DbParameterCollection
Zastaralé.

Získá kolekci DbParameter objektů.

(Zděděno od DbCommand)
DbTransaction
Zastaralé.

Získá nebo nastaví, DbTransaction v rámci kterého se tento DbCommand objekt spustí.

(Zděděno od DbCommand)
DesignMode
Zastaralé.

Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component .

(Zděděno od Component)
DesignTimeVisible
Zastaralé.

Získá nebo nastaví hodnotu označující, zda příkaz objektu by měl být viditelný v přizpůsobeném ovládacím prvku rozhraní.

Events
Zastaralé.

Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component.

(Zděděno od Component)
Parameters
Zastaralé.

Získá .OracleParameterCollection

Site
Zastaralé.

Získá nebo nastaví ISite z Component.

(Zděděno od Component)
Transaction
Zastaralé.

Získá nebo nastaví, OracleTransaction v rámci kterého se OracleCommand spustí.

UpdatedRowSource
Zastaralé.

Získá nebo nastaví hodnotu, která určuje, jak Update má metoda použít výsledky příkazu na DataRow.

Metody

Cancel()
Zastaralé.

Pokusí se zrušit spuštění objektu OracleCommand.

Clone()
Zastaralé.

Vytvoří kopii tohoto OracleCommand objektu.

CreateDbParameter()
Zastaralé.

Vytvoří novou instanci objektu DbParameter .

(Zděděno od DbCommand)
CreateObjRef(Type)
Zastaralé.

Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem.

(Zděděno od MarshalByRefObject)
CreateParameter()
Zastaralé.

Vytvoří novou instanci objektu OracleParameter .

Dispose()
Zastaralé.

Uvolní všechny prostředky používané nástrojem Component.

(Zděděno od Component)
Dispose()
Zastaralé.

Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků.

(Zděděno od DbCommand)
Dispose(Boolean)
Zastaralé.

Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky.

(Zděděno od Component)
Dispose(Boolean)
Zastaralé.

Uvolní nespravované prostředky používané nástrojem DbCommand a volitelně uvolní spravované prostředky.

(Zděděno od DbCommand)
DisposeAsync()
Zastaralé.

Asynchronně rozloží objekt příkazu.

(Zděděno od DbCommand)
Equals(Object)
Zastaralé.

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)
Zastaralé.

Spustí příkaz proti jeho připojení a vrátí , DbDataReader který lze použít pro přístup k výsledkům.

(Zděděno od DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)
Zastaralé.

Zprostředkovatelé by měli implementovat tuto metodu, aby poskytovala jinou než výchozí implementaci přetížení ExecuteReader .

Výchozí implementace vyvolá synchronní ExecuteReader() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané ExecuteReader budou oznámeny prostřednictvím vrácené Task Exception vlastnost.

Tato metoda přijímá token zrušení, který lze použít k žádosti o předčasné zrušení operace. Implementace můžou tento požadavek ignorovat.

(Zděděno od DbCommand)
ExecuteNonQuery()
Zastaralé.

Provede příkaz SQL proti Connection a vrátí počet ovlivněných řádků.

ExecuteNonQueryAsync()
Zastaralé.

Asynchronní verze nástroje ExecuteNonQuery(), která spustí příkaz proti objektu připojení a vrátí počet ovlivněných řádků.

ExecuteNonQueryAsync(CancellationToken) Vyvolá s CancellationToken.None.

(Zděděno od DbCommand)
ExecuteNonQueryAsync(CancellationToken)
Zastaralé.

Toto je asynchronní verze nástroje ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení se může volitelně ignorovat.

Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteNonQuery() budou oznámeny prostřednictvím vrácené vlastnosti Task Exception (Výjimka úkolu).

Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud vrácená úloha není dokončena.

(Zděděno od DbCommand)
ExecuteOracleNonQuery(OracleString)
Zastaralé.

Provede příkaz SQL proti Connection a vrátí počet ovlivněných řádků.

ExecuteOracleScalar()
Zastaralé.

Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vrácený dotazem jako datový typ specifický pro Oracle. Nadbytečné sloupce nebo řádky se ignorují.

ExecuteReader()
Zastaralé.

Odešle do objektu CommandTextConnection a vytvoří OracleDataReader.

ExecuteReader(CommandBehavior)
Zastaralé.

Odešle do objektu CommandTextConnectiona vytvoří OracleDataReader objekt pomocí jedné z CommandBehavior hodnot.

ExecuteReaderAsync()
Zastaralé.

Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí objekt , DbDataReader který lze použít pro přístup k výsledkům.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Vyvolá s CancellationToken.None.

(Zděděno od DbCommand)
ExecuteReaderAsync(CancellationToken)
Zastaralé.

Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí objekt , DbDataReader který lze použít pro přístup k výsledkům.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá .

(Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior)
Zastaralé.

Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí objekt , DbDataReader který lze použít pro přístup k výsledkům.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá .

(Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)
Zastaralé.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá .

(Zděděno od DbCommand)
ExecuteScalar()
Zastaralé.

Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vrácené dotazem jako datový typ .NET. Nadbytečné sloupce nebo řádky se ignorují.

ExecuteScalarAsync()
Zastaralé.

Asynchronní verze nástroje ExecuteScalar(), která spustí příkaz a vrátí první sloupec prvního řádku v první vrácené sadě výsledků. Všechny ostatní sloupce, řádky a sady výsledků se ignorují.

ExecuteScalarAsync(CancellationToken) Vyvolá s CancellationToken.None.

(Zděděno od DbCommand)
ExecuteScalarAsync(CancellationToken)
Zastaralé.

Toto je asynchronní verze nástroje ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení se může volitelně ignorovat.

Výchozí implementace vyvolá synchronní ExecuteScalar() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno. Výchozí implementace vrátí zrušenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané executeScalar budou oznámeny prostřednictvím vrácené task exception vlastnost.

Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud vrácená úloha není dokončena.

(Zděděno od DbCommand)
GetHashCode()
Zastaralé.

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetLifetimeService()
Zastaralé.

Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
GetService(Type)
Zastaralé.

Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container

(Zděděno od Component)
GetType()
Zastaralé.

Type Získá z aktuální instance.

(Zděděno od Object)
InitializeLifetimeService()
Zastaralé.

Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci.

(Zděděno od MarshalByRefObject)
MemberwiseClone()
Zastaralé.

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
MemberwiseClone(Boolean)
Zastaralé.

Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu.

(Zděděno od MarshalByRefObject)
Prepare()
Zastaralé.

Vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.

PrepareAsync(CancellationToken)
Zastaralé.

Asynchronně vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.

(Zděděno od DbCommand)
ResetCommandTimeout()
Zastaralé.

CommandTimeout Obnoví vlastnost na výchozí hodnotu.

ToString()
Zastaralé.

String Vrátí hodnotu obsahující název , Componentpokud existuje. Tato metoda by neměla být přepsána.

(Zděděno od Component)

Událost

Disposed
Zastaralé.

Vyvolá se, když je komponenta uvolněna voláním Dispose() metody .

(Zděděno od Component)

Explicitní implementace rozhraní

IDbCommand.Connection
Zastaralé.

Získá nebo nastaví IDbConnection používaná touto instancí objektu IDbCommand.

(Zděděno od DbCommand)
IDbCommand.CreateParameter()
Zastaralé.

Vytvoří novou instanci objektu IDbDataParameter .

IDbCommand.CreateParameter()
Zastaralé.

Vytvoří novou instanci objektu IDbDataParameter .

(Zděděno od DbCommand)
IDbCommand.ExecuteReader()
Zastaralé.

CommandText Spustí proti objektu Connection a vytvoří IDataReader.

IDbCommand.ExecuteReader()
Zastaralé.

CommandText Spustí proti objektu Connection a vytvoří IDataReader.

(Zděděno od DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)
Zastaralé.

CommandText Spustí proti objektu Connectiona pomocí jedné z CommandBehavior hodnot sestaví IDataReader objekt .

IDbCommand.ExecuteReader(CommandBehavior)
Zastaralé.

CommandText Spustí proti objektu Connectiona sestaví IDataReader objekt pomocí jedné z CommandBehavior hodnot.

(Zděděno od DbCommand)
IDbCommand.Parameters
Zastaralé.

Získá .IDataParameterCollection

(Zděděno od DbCommand)
IDbCommand.Transaction
Zastaralé.

Získá nebo nastaví, DbTransaction v rámci kterého se tento DbCommand objekt spustí.

(Zděděno od DbCommand)

Platí pro

Viz také