OleDbCommand Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v9.0.0-rc.1.24431.7

Zdroj:

OleDbCommand.cs

Představuje příkaz SQL nebo uloženou proceduru, která se má provést ve zdroji dat.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable

public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable

type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Dědičnost

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

Implementuje

IDbCommand ICloneable IDisposable

Příklady

Následující příklad používá OleDbCommand, podél OleDbDataAdapter a OleDbConnection, k výběru řádků z accessové databáze. Potom se vrátí vyplněný DataSet. Příklad se předá inicializovaný DataSet, připojovací řetězec, řetězec dotazu, který je příkazem SQL SELECT, a řetězec, který je názvem zdrojové tabulky databáze.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}

Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Poznámky

Při vytvoření instance OleDbCommand jsou vlastnosti pro čtení a zápis nastaveny na jejich počáteční hodnoty. Seznam těchto hodnot najdete v OleDbCommand konstruktoru.

OleDbCommand nabízí následující metody, které spouští příkazy ve zdroji dat:

Položka	Popis
ExecuteReader	Spustí příkazy, které vracejí řádky. ExecuteReader nemusí mít vliv, který chcete použít ke spouštění příkazů, jako jsou příkazy SQL SET.
ExecuteNonQuery	Spouští příkazy, jako jsou příkazy SQL INSERT, DELETE, UPDATE a SET.
ExecuteScalar	Načte jednu hodnotu, například agregační hodnotu z databáze.

Vlastnost CommandText můžete obnovit a znovu použít objekt OleDbCommand. Před spuštěním nového nebo předchozího příkazu však musíte OleDbDataReader zavřít.

Pokud je závažná OleDbException (například úroveň závažnosti SQL Serveru 20 nebo vyšší) vygenerována metodou, která spouští OleDbCommand, může být připojení uzavřeno OleDbConnection. Uživatel ale může znovu otevřít připojení a pokračovat.

Konstruktory

OleDbCommand()	Inicializuje novou instanci OleDbCommand třídy.
OleDbCommand(String)	Inicializuje novou instanci třídy OleDbCommand textem dotazu.
OleDbCommand(String, OleDbConnection)	Inicializuje novou instanci třídy OleDbCommand s textem dotazu a OleDbConnection.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializuje novou instanci třídy OleDbCommand s textem dotazu, OleDbConnectiona Transaction.

Vlastnosti

CanRaiseEvents	Získá hodnotu určující, zda komponenta může vyvolat událost. (Zděděno od Component)
CommandText	Získá nebo nastaví příkaz SQL nebo uloženou proceduru ke spuštění ve zdroji dat.
CommandTimeout	Získá nebo nastaví dobu čekání (v sekundách) před ukončením pokusu o spuštění příkazu a generování chyby.
CommandType	Získá nebo nastaví hodnotu, která určuje, jak CommandText vlastnost je interpretována.
Connection	Získá nebo nastaví OleDbConnection používané touto instancí OleDbCommand.
Container	Získá IContainer, který obsahuje Component. (Zděděno od Component)
DbConnection	Získá nebo nastaví DbConnection používané tímto DbCommand. (Zděděno od DbCommand)
DbParameterCollection	Získá kolekci DbParameter objektů. (Zděděno od DbCommand)
DbTransaction	Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí. (Zděděno od DbCommand)
DesignMode	Získá hodnotu, která označuje, zda Component je aktuálně v režimu návrhu. (Zděděno od Component)
DesignTimeVisible	Získá nebo nastaví hodnotu, která určuje, zda objekt příkazu by měl být viditelný v přizpůsobeném ovládacím prvku Windows Forms Designer.
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
Parameters	Získá OleDbParameterCollection.
Site	Získá nebo nastaví ISiteComponent. (Zděděno od Component)
Transaction	Získá nebo nastaví OleDbTransaction, ve kterém se OleDbCommand spustí.
UpdatedRowSource	Získá nebo nastaví způsob použití výsledků příkazu na DataRow při použití Update metoda OleDbDataAdapter.

Metody

Cancel()	Pokusí se zrušit provádění OleDbCommand.
Clone()	Vytvoří nový OleDbCommand objekt, který je kopií aktuální instance.
CreateDbParameter()	Vytvoří novou instanci objektu DbParameter. (Zděděno od DbCommand)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužícího ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
CreateParameter()	Vytvoří novou instanci objektu OleDbParameter.
Dispose()	Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků. (Zděděno od DbCommand)
Dispose(Boolean)	Uvolní nespravované prostředky používané DbCommand a volitelně uvolní spravované prostředky. (Zděděno od DbCommand)
DisposeAsync()	Asynchronně disponuje objekt příkazu. (Zděděno od DbCommand)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)	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)	Zprostředkovatelé by měli tuto metodu implementovat, aby poskytovali ne výchozí implementaci pro ExecuteReader přetížení. 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šený úkol, pokud už byl 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 vyžádání operace, aby byla zrušena dříve. Implementace můžou tento požadavek ignorovat. (Zděděno od DbCommand)
ExecuteNonQuery()	Provede příkaz SQL na Connection a vrátí počet ovlivněných řádků.
ExecuteNonQueryAsync()	Asynchronní verze ExecuteNonQuery(), která spustí příkaz proti jeho objektu připojení, vrací počet ovlivněných řádků. Vyvolá ExecuteNonQueryAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Toto je asynchronní verze ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteNonQuery() budou předány prostřednictvím vrácené vlastnosti Exception úlohy. Nevyvolejte jiné metody a vlastnosti DbCommand objektu, dokud vrácená úloha není dokončena. (Zděděno od DbCommand)
ExecuteReader()	Odešle CommandText do Connection a vytvoří OleDbDataReader.
ExecuteReader(CommandBehavior)	Odešle CommandText do Connectiona vytvoří OleDbDataReader pomocí jedné z hodnot CommandBehavior.
ExecuteReaderAsync()	Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand)
ExecuteReaderAsync(CancellationToken)	Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior)	Asynchronní verze ExecuteReader, která spustí příkaz proti jeho připojení, vrací DbDataReader, které lze použít pro přístup k výsledkům. Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken). (Zděděno od DbCommand)
ExecuteScalar()	Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácených dotazem. Další sloupce nebo řádky se ignorují.
ExecuteScalarAsync()	Asynchronní verze 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í. Vyvolá ExecuteScalarAsync(CancellationToken) pomocí CancellationToken.None. (Zděděno od DbCommand)
ExecuteScalarAsync(CancellationToken)	Toto je asynchronní verze ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací. Token zrušení může být volitelně ignorován. 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteScalar budou oznámeny prostřednictvím vrácené task Exception vlastnost. Nevyvolejte jiné metody a vlastnosti DbCommand objektu, dokud vrácená úloha není dokončena. (Zděděno od DbCommand)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou Component nebo jeho Container. (Zděděno od Component)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního objektu MarshalByRefObject. (Zděděno od MarshalByRefObject)
Prepare()	Vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat.
PrepareAsync(CancellationToken)	Asynchronně vytvoří připravenou (nebo zkompilovanou) verzi příkazu ve zdroji dat. (Zděděno od DbCommand)
ResetCommandTimeout()	Obnoví vlastnost CommandTimeout na výchozí hodnotu.
ToString()	Vrátí String obsahující název Component, pokud existuje. Tato metoda by neměla být přepsána. (Zděděno od Component)

Událost

Disposed

Nastane, když komponenta je uvolněna voláním Dispose() metody. (Zděděno od Component)

Explicitní implementace rozhraní

ICloneable.Clone()	Popis tohoto člena najdete v tématu Clone().
IDbCommand.Connection	Získá nebo nastaví IDbConnection používané touto instancí IDbCommand. (Zděděno od DbCommand)
IDbCommand.CreateParameter()	Vytvoří novou instanci objektu IDbDataParameter. (Zděděno od DbCommand)
IDbCommand.ExecuteReader()	Popis tohoto člena najdete v tématu ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	Spustí CommandText proti Connectiona vytvoří IDataReader pomocí jedné z hodnot CommandBehavior.
IDbCommand.Parameters	Získá IDataParameterCollection. (Zděděno od DbCommand)
IDbCommand.Transaction	Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí. (Zděděno od DbCommand)

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak čekají na úlohy vrácené z asynchronního jednorázového použití.

Viz také

• OleDbDataAdapter
• OleDbConnection
• práce s příkazy