OracleCommand Třída

Reference

Definice

Obor názvů:: System.Data.OracleClient

Sestavení:: System.Data.OracleClient.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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: Object

MarshalByRefObject

Component
OracleCommand

Dědičnost: Object

MarshalByRefObject

Component

DbCommand
OracleCommand

Atributy: ObsoleteAttribute

Implementuje: IDbCommand ICloneable IDisposable

Příklady

Následující příklad používá metodu ExecuteReader OracleCommand, 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 CommandText Connection a vytvoří OracleDataReader.
ExecuteReader(CommandBehavior)	Zastaralé. Odešle do objektu CommandText Connectiona 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é

Práce s příkazy

Sdílet prostřednictvím