OleDbCommand Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v9.0.0-preview.3.24172.9

Zdroj:

OleDbCommand.cs

Představuje příkaz SQL nebo uloženou proceduru, která se má provést proti 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 ICloneable
    interface IDbCommand
    interface IDisposable

Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable

Dědičnost

Object

MarshalByRefObject

Component

DbCommand

OleDbCommand

Implementuje

IDbCommand ICloneable IDisposable

Příklady

V následujícím příkladu OleDbCommandse k výběru řádků z accessové databáze používají příkazy , spolu OleDbDataAdapter a OleDbConnection. Vyplněný DataSet se pak vrátí. Příklad je předán inicializovaný DataSet, připojovací řetězec, řetězec dotazu, který je příkazem SQL SELECT, a řetězec, který je názvem tabulky zdrojové 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 objektu OleDbCommand jsou vlastnosti pro čtení a zápis nastaveny na jejich počáteční hodnoty. Seznam těchto hodnot najdete v konstruktoru OleDbCommand .

OleDbCommand funkce následujících metod spouštění příkazů ve zdroji dat:

Položka	Popis
ExecuteReader	Spustí příkazy, které vrací řádky. ExecuteReader nemusí mít požadovaný účinek, pokud se používá 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 agregovanou hodnotu z databáze.

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

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

Konstruktory

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

Vlastnosti

CanRaiseEvents	Získá hodnotu označ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á označuje, jak CommandText je interpretována vlastnost.
Connection	Získá nebo nastaví použitou OleDbConnection touto instancí objektu OleDbCommand.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
DbConnection	Získá nebo nastaví DbConnection použitý 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 tento DbCommand objekt provede. (Zděděno od DbCommand)
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
DesignTimeVisible	Získá nebo nastaví hodnotu, která označuje, zda příkaz objektu by měl být viditelný v přizpůsobené model Windows Forms Designer ovládací prvek.
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í ISite hodnotu Component. (Zděděno od Component)
Transaction	Získá nebo nastaví, OleDbTransaction v rámci kterého se OleDbCommand provede.
UpdatedRowSource	Získá nebo nastaví způsob použití výsledků DataRow příkazu při použití metodou UpdateOleDbDataAdapter.

Metody

Cancel()	Pokusí se zrušit spuštění objektu 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 používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
CreateParameter()	Vytvoří novou instanci objektu OleDbParameter .
Dispose()	Provede aplikací definované úlohy spojené s 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 nástrojem a volitelně uvolní spravované prostředky. (Zděděno od DbCommand)
DisposeAsync()	Asynchronně rozdělí objekt příkazu. (Zděděno od DbCommand)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)	Spustí příkaz proti jeho připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. (Zděděno od DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	Zprostředkovatelé by měli implementovat tuto metodu, aby poskytovala pro přetížení jinou než výchozí implementaci 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é nástrojem ExecuteReader budou sděleny prostřednictvím vlastnosti vrácené výjimky úlohy. 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()	Spustí příkaz SQL proti Connection a vrátí počet ovlivněných řádků.
ExecuteNonQueryAsync()	Asynchronní verze nástroje ExecuteNonQuery(), která provede příkaz proti objektu připojení a vrátí počet ovlivněných řádků. Vyvolá pomocí ExecuteNonQueryAsync(CancellationToken) CancellationToken.None. (Zděděno od DbCommand)
ExecuteNonQueryAsync(CancellationToken)	Toto je asynchronní verze nástroje 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šenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteNonQuery() budou sděleny prostřednictvím vrácené vlastnosti Výjimka úkolu. Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud nebude dokončena vrácená úloha. (Zděděno od DbCommand)
ExecuteReader()	Odešle do CommandText objektu Connection a vytvoří OleDbDataReader.
ExecuteReader(CommandBehavior)	Odešle hodnotu CommandText do a vytvoří OleDbDataReader objekt pomocí jedné z CommandBehaviorConnectionhodnot.
ExecuteReaderAsync()	Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. Vyvolá pomocí ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) CancellationToken.None. (Zděděno od DbCommand)
ExecuteReaderAsync(CancellationToken)	Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior)	Asynchronní verze nástroje ExecuteReader, která spustí příkaz proti svému připojení a vrátí DbDataReader příkaz, který lze použít pro přístup k výsledkům. ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteScalar()	Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků vrácené dotazem. Další sloupce nebo řádky se ignorují.
ExecuteScalarAsync()	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í. Vyvolá pomocí ExecuteScalarAsync(CancellationToken) CancellationToken.None. (Zděděno od DbCommand)
ExecuteScalarAsync(CancellationToken)	Toto je asynchronní verze nástroje 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šenou úlohu, pokud je předán již zrušený token zrušení. Výjimky vyvolané nástrojem ExecuteScalar budou sděleny prostřednictvím vrácené vlastnosti Task Exception. Nevyvolávej jiné metody a vlastnosti objektu DbCommand , dokud nebude dokončena vrácená úloha. (Zděděno od DbCommand)
GetHashCode()	Slouží jako výchozí hashovací funkce. (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 objektem Component nebo jejím Containerobjektem . (Zděděno od Component)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (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()	CommandTimeout Obnoví vlastnost na výchozí hodnotu.
ToString()	String Vrátí hodnotu 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ž je komponenta odstraně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í použitou IDbConnection touto instancí objektu 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í proti CommandTextConnectiona vytvoří IDataReader objekt pomocí jedné z CommandBehavior hodnot.
IDbCommand.Parameters	Získá .IDataParameterCollection (Zděděno od DbCommand)
IDbCommand.Transaction	Získá nebo nastaví, DbTransaction ve kterém tento DbCommand objekt provede. (Zděděno od DbCommand)

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí čekání na úlohy vrácené z asynchronního jednorázového použití.

Viz také

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