DbCommand Třída

Definice

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

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 text pro spuštění proti 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 CommandText interpretace vlastnosti.

Connection

Získá nebo nastaví DbConnection použitý tímto DbCommand.

Container

Získá objekt IContainer , který obsahuje Component.

(Zděděno od Component)
DbConnection

Získá nebo nastaví DbConnection použitý tímto DbCommand.

DbParameterCollection

Získá kolekci DbParameter objektů.

DbTransaction

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

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 určující, zda příkaz objektu by měl být viditelný v přizpůsobeném ovládacím prvku rozhraní.

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í ISite hodnotu Component.

(Zděděno od Component)
Transaction

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

UpdatedRowSource

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

Metody

Cancel()

Pokusy o zrušení provádění DbCommandpříkazu .

CreateDbParameter()

Vytvoří novou instanci objektu DbParameter .

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

Dispose()

Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků.

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 nástrojem a volitelně uvolní spravované prostředky.

Dispose(Boolean)

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

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

Asynchronně rozdělí objekt příkazu.

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.

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.

ExecuteNonQuery()

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

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.

ExecuteReader()

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

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

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.

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

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

ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Vyvolá .

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

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.

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.

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

(Zděděno od Component)

Explicitní implementace rozhraní

IDbCommand.Connection

Získá nebo nastaví použitou IDbConnection touto instancí objektu IDbCommand.

IDbCommand.CreateParameter()

Vytvoří novou instanci objektu IDbDataParameter .

IDbCommand.ExecuteReader()

Spustí proti CommandTextConnection a vytvoří IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Spustí proti CommandTextConnectiona vytvoří IDataReader objekt pomocí jedné z CommandBehavior hodnot.

IDbCommand.Parameters

Získá .IDataParameterCollection

IDbCommand.Transaction

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

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce awaits u úloh vrácených z asynchronního jednorázového režimu.

Platí pro

Viz také