OleDbCommand Třída

Definice

Obor názvů:

System.Data.OleDb

Sestavení:

System.Data.OleDb.dll

Balíček:

System.Data.OleDb v8.0.0

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

DbCommand

OleDbCommand

Implementuje

IDbCommand ICloneable IDisposable

Příklady

V následujícím příkladu se OleDbCommandk výběru řádků z accessové databáze používají , spolu OleDbDataAdapter a OleDbConnection. Vyplněná DataSet hodnota 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 počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru OleDbCommand .

OleDbCommand obsahuje následující metody spouštění příkazů ve zdroji dat:

Položka	Popis
ExecuteReader	Spustí příkazy, které vracejí řádky. ExecuteReader nemusí mít požadovaný účinek, pokud se používají 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 zavřít příkaz .

Pokud je závažná OleDbException (například SQL Server úroveň závažnosti 20 nebo vyšší) vygenerována metodou, která OleDbCommandspouští , OleDbConnection, může být připojení ukončeno. 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 OleDbCommand třídy s textem dotazu.
OleDbCommand(String, OleDbConnection)	Inicializuje novou instanci OleDbCommand třídy s textem dotazu a objektem OleDbConnection.
OleDbCommand(String, OleDbConnection, OleDbTransaction)	Inicializuje novou instanci OleDbCommand třídy s textem dotazu , OleDbConnectiona Transaction.

Vlastnosti

CommandText	Získá nebo nastaví sql příkaz nebo uložená procedura ke spuštění ve zdroji dat.
CommandTimeout	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	Získá nebo nastaví hodnotu, která označuje, jak CommandText je interpretována vlastnost.
Connection	Získá nebo nastaví OleDbConnection používaná touto instancí objektu OleDbCommand.
DbConnection	Získá nebo nastaví DbConnection používaná tímto DbCommandobjektem . (Zděděno od DbCommand)
DbParameterCollection	Získá kolekci DbParameter objektů. (Zděděno od DbCommand)
DbTransaction	Získá nebo nastaví, DbTransaction v rámci kterého se tento DbCommand objekt spustí. (Zděděno od DbCommand)
DesignTimeVisible	Získá nebo nastaví hodnotu, která označuje, zda má být objekt příkazu viditelný v přizpůsobeném ovládacím prvku model Windows Forms Designer.
Parameters	Získá .OleDbParameterCollection
Transaction	Získá nebo nastaví, OleDbTransaction v rámci kterého se OleDbCommand spustí.
UpdatedRowSource	Získá nebo nastaví způsob použití výsledků příkazu na DataRow 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)
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é nástrojem DbCommand a volitelně uvolní spravované prostředky. (Zděděno od DbCommand)
DisposeAsync()	Asynchronně rozloží 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 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 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()	Provede příkaz SQL proti Connection a vrátí počet ovlivněných řádků.
ExecuteNonQueryAsync()	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)	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)
ExecuteReader()	Odešle do objektu CommandTextConnection a vytvoří OleDbDataReader.
ExecuteReader(CommandBehavior)	Odešle do objektu CommandTextConnectiona vytvoří OleDbDataReader objekt pomocí jedné z CommandBehavior hodnot.
ExecuteReaderAsync()	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)	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)	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)	ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá . (Zděděno od DbCommand)
ExecuteScalar()	Spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vrácené dotazem. Další sloupce nebo řádky jsou ignorovány.
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í. ExecuteScalarAsync(CancellationToken) Vyvolá s 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í 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()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Prepare()	Vytvoří připravenou (nebo zkompilovanou) verzi příkazu pro zdroj 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()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ICloneable.Clone()	Popis tohoto člena najdete v tématu Clone().
IDbCommand.ExecuteReader()	Popis tohoto člena najdete v tématu ExecuteReader().
IDbCommand.ExecuteReader(CommandBehavior)	CommandText Spustí proti objektu Connectiona sestaví IDataReader objekt pomocí jedné z CommandBehavior hodnot.

Viz také

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