OleDbCommand Třída

Definice

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
public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Dědičnost
OleDbCommand
Dědičnost
Dědičnost
Implementuje

Příklady

Následující příklad používá OleDbCommandpříkaz ,spolu OleDbDataAdapter a OleDbConnection) k výběru řádků z accessové databáze. Vyplněný DataSet se pak vrátí. 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é databázové tabulky.

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 se vlastnosti čtení a zápisu nastaví 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 vliv, který chcete použít ke spouštění příkazů, jako jsou příkazy SQL SET.
ExecuteNonQuery Spustí 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 můžete resetovat CommandText a znovu použít OleDbCommand objekt. Před spuštěním nového nebo předchozího příkazu však musíte zavřít OleDbDataReader .

Pokud je závažná OleDbException (například SQL Server úroveň závažnosti 20 nebo vyšší) vygenerovaná metodou spuštění OleDbCommand, OleDbConnectionmůže být připojení uzavř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 .OleDbConnection

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inicializuje novou instanci OleDbCommand třídy s textem dotazu, an 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 pro 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 vlastnost interpretována.

Connection

Získá nebo nastaví OleDbConnection používané touto instancí OleDbCommand.

Container

IContainer Získá ten, 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 se tento DbCommand objekt spustí.

(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 má být objekt příkazu viditelný v přizpůsobeném model Windows Forms Návrhář ovládacího prvku.

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 of the Component.

(Zděděno od Component)
Transaction

Získá nebo nastaví OleDbTransaction , ve kterém OleDbCommand se spustí.

UpdatedRowSource

Získá nebo nastaví způsob použití výsledků příkazu při DataRow použití Update metodou OleDbDataAdapter.

Metody

Cancel()

Pokusí se zrušit provádění příkazu 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 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()

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

(Zděděno od Component)
Dispose(Boolean)

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

(Zděděno od DbCommand)
Dispose(Boolean)

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

(Zděděno od Component)
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ý se dá použít pro přístup k výsledkům.

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

Poskytovatelé by měli tuto metodu implementovat, aby poskytovali 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šený úkol, pokud už byl zrušený token zrušení. Výjimky vyvolané ExecuteReader se předávají prostřednictvím vrácené vlastnosti Výjimky úlohy.

Tato metoda přijímá token zrušení, který lze použít k vyžádání operace, aby byla zrušena brzy. Implementace mohou tuto žádost ignorovat.

(Zděděno od DbCommand)
ExecuteNonQuery()

Spustí příkaz SQL na základě 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ů.

ExecuteNonQueryAsync(CancellationToken) Vyvolá se pomocí funkce CancellationToken.None.

(Zděděno od DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Toto je asynchronní verze ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementaci. 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 vyvoláné pomocí ExecuteNonQuery() vrácené vlastnosti Výjimky úkolu.

Nevyvolejte jiné metody a vlastnosti objektu DbCommand , dokud nebude vrácený úkol dokončen.

(Zděděno od DbCommand)
ExecuteReader()

CommandText Odešle zprávu a Connection vytvoří .OleDbDataReader

ExecuteReader(CommandBehavior)

CommandText Odešle do objektu Connectiona vytvoří OleDbDataReader jednu z hodnot pomocí jedné z CommandBehavior hodnot.

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) se 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.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá .

(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.

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ý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) se 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 již byl zrušený token zrušení. Výjimky vyvolané executeScalar budou předány prostřednictvím vrácené vlastnosti Task Exception.

Nevyvolejte jiné metody a vlastnosti objektu DbCommand , dokud nebude vrácený úkol dokončen.

(Zděděno od DbCommand)
GetHashCode()

Slouží jako výchozí funkce hash.

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

Načte aktuální objekt služby ž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 službou Component nebo jejím Containerobjektem .

(Zděděno od Component)
GetType()

Type Získá aktuální instanci.

(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ří použádnou kopii aktuálního souboru Object.

(Zděděno od Object)
MemberwiseClone(Boolean)

Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět.

(Zděděno od MarshalByRefObject)
Prepare()

Vytvoří připravenou (nebo kompilovanou) 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()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)
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ž komponenta je odstraněna voláním Dispose() metody.

(Zděděno od Component)

Explicitní implementace rozhraní

ICloneable.Clone()

Popis tohoto člena naleznete v tématu Clone().

IDbCommand.Connection

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

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

Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu.

Vytvoří novou instanci objektu IDbDataParameter .

IDbCommand.CreateParameter()

Vytvoří novou instanci objektu IDbDataParameter .

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

Popis tohoto člena naleznete v tématu ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

CommandText Provede proti objektu Connectiona vytvoří IDataReader jednu z hodnot 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 se tento DbCommand objekt spustí.

(Zděděno od DbCommand)

Platí pro

Viz také