DbCommand Třída

Definice

Představuje příkaz SQL nebo uloženou proceduru, která se má provést ve zdroji dat. Poskytuje základní třídu pro třídy specifické pro databázi, které představují příkazy. ExecuteNonQueryAsync.

public ref class DbCommand abstract : IDisposable
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IDisposable, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, System::Data::IDbCommand
public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, System::Data::IDbCommand
public abstract class DbCommand : IDisposable
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IDisposable, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, System.Data.IDbCommand
public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, System.Data.IDbCommand
type DbCommand = class
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable
type DbCommand = class
    interface IDbCommand
    interface IDisposable
type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
Public MustInherit Class DbCommand
Implements IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable
Public MustInherit Class DbCommand
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable
Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand
Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand
Dědičnost
DbCommand
Dědičnost
Odvozené
Implementuje

Konstruktory

DbCommand()

Vytvoří instanci DbCommand objektu.

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í textový příkaz 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í způsob interpretace CommandText vlastnost.

Connection

Získá nebo nastaví DbConnection používané tímto DbCommand.

Container

Získá IContainer, který obsahuje Component.

(Zděděno od Component)
DbConnection

Získá nebo nastaví DbConnection používané tímto DbCommand.

DbParameterCollection

Získá kolekci DbParameter objektů.

DbTransaction

Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí.

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 určující, zda příkazový objekt by měl být viditelný v přizpůsobeném rozhraní 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á kolekci DbParameter objektů. Další informace o parametrech najdete v tématu Konfigurace parametrů a datových typů parametrů.

Site

Získá nebo nastaví ISiteComponent.

(Zděděno od Component)
Transaction

Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí.

UpdatedRowSource

Získá nebo nastaví způsob použití výsledků příkazu na DataRow při použití update metoda DbDataAdapter.

Metody

Cancel()

Pokusí se zrušit spuštění DbCommand.

CreateDbParameter()

Vytvoří novou instanci objektu DbParameter.

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

Dispose()

Provádí úlohy definované aplikací související s uvolněním, uvolněním nebo resetováním nespravovaných prostředků.

Dispose()

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

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

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

Dispose(Boolean)

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

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

Asynchronně disponuje objekt příkazu.

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.

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.

ExecuteNonQuery()

Spustí příkaz proti jeho objektu připojení 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.

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.

ExecuteReader()

Spustí příkaz proti jeho připojení a vrátí DbDataReader, který lze použít pro přístup k výsledkům.

ExecuteReader(CommandBehavior)

Spustí příkaz proti jeho připojení a vrátí DbDataReader, který lze použít pro přístup k výsledkům.

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.

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

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

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

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

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.

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.

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.

ToString()

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

(Zděděno od Object)
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í

IDbCommand.Connection

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

IDbCommand.CreateParameter()

Vytvoří novou instanci objektu IDbDataParameter.

IDbCommand.ExecuteReader()

Spustí CommandText proti Connection a vytvoří IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Spustí CommandText proti Connectiona vytvoří IDataReader pomocí jedné z hodnot CommandBehavior.

IDbCommand.Parameters

Získá IDataParameterCollection.

IDbCommand.Transaction

Získá nebo nastaví DbTransaction, ve kterém se tento DbCommand objekt spustí.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

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

Platí pro

Viz také

  • přehled ADO.NET