DbCommand Třída

Definice

Představuje příkaz SQL nebo uloženou proceduru, která se má provést na zdroji dat.Represents an SQL statement or stored procedure to execute against a data source. Poskytuje základní třídu pro třídy specifické pro databázi, které představují příkazy.Provides a base class for database-specific classes that represent commands. 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.Constructs an instance of the DbCommand object.

Vlastnosti

CanRaiseEvents

Získá hodnotu, která označuje, zda může komponenta vyvolat událost.Gets a value indicating whether the component can raise an event.

(Zděděno od Component)
CommandText

Při přepsání v odvozené třídě získá nebo nastaví příkaz text, který se má spustit proti zdroji dat.When overridden in a derived class, gets or sets the text command to run against the data source.

CommandTimeout

Při přepsání v odvozené třídě získá nebo nastaví čekací dobu (v sekundách) před ukončením pokusu o spuštění příkazu a vygenerováním chyby.When overridden in a derived class, gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Při přepsání v odvozené třídě získá nebo nastaví způsob CommandText Interpretace vlastnosti.When overridden in a derived class, gets or sets how the CommandText property is interpreted.

Connection

Získá nebo nastaví DbConnection použitou tuto DbCommand .Gets or sets the DbConnection used by this DbCommand.

Container

Získá IContainer , který obsahuje Component .Gets the IContainer that contains the Component.

(Zděděno od Component)
DbConnection

Při přepsání v odvozené třídě získá nebo nastaví hodnotu DbConnection použitou tímto DbCommand .When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

DbParameterCollection

Při přepsání v odvozené třídě získá kolekci DbParameter objektů.When overridden in a derived class, gets the collection of DbParameter objects.

DbTransaction

Při přepsání v odvozené třídě získává nebo nastavuje, DbTransaction ve kterém se tento DbCommand objekt spustí.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode

Načte hodnotu, která označuje, zda Component je aktuálně v režimu návrhu.Gets a value that indicates whether the Component is currently in design mode.

(Zděděno od Component)
DesignTimeVisible

Při přepsání v odvozené třídě získává nebo nastavuje hodnotu, která označuje, zda by měl být objekt příkazu viditelný v přizpůsobeném ovládacím prvku rozhraní.When overridden in a derived class, gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events

Získá seznam obslužných rutin událostí, které jsou k tomuto typu připojeny Component .Gets the list of event handlers that are attached to this Component.

(Zděděno od Component)
Parameters

Získá kolekci DbParameter objektů.Gets the collection of DbParameter objects. Další informace o parametrech najdete v tématu Konfigurace parametrů a datových typů parametrů.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site

Získá nebo nastaví ISite z Component .Gets or sets the ISite of the Component.

(Zděděno od Component)
Transaction

Získá nebo nastaví, DbTransaction ve kterém se tento DbCommand objekt spustí.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource

Při přepsání v odvozené třídě získá nebo nastaví způsob, jakým jsou výsledky příkazu použity pro metodu, která je DataRow použita metodou aktualizace pro DbDataAdapter .When overridden in a derived class, gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

Metody

Cancel()

Při přepsání v odvozené třídě se pokusí zrušit provádění DbCommand .When overridden in a derived class, attempts to cancel the execution of a DbCommand.

CreateDbParameter()

Při přepsání v odvozené třídě vytvoří novou instanci DbParameter objektu.When overridden in a derived class, creates a new instance of a DbParameter object.

CreateObjRef(Type)

Vytvoří objekt, který obsahuje všechny relevantní informace požadované pro vygenerování proxy serveru, který se používá ke komunikaci se vzdáleným objektem.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

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

Vytvoří novou instanci DbParameter objektu.Creates a new instance of a DbParameter object.

Dispose()

Provede aplikací definované úlohy spojené s uvolněním nebo resetováním nespravovaných prostředků.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Uvolní všechny prostředky, které používá Component .Releases all resources used by the Component.

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

Uvolní nespravované prostředky používané DbCommand a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the DbCommand and optionally releases the managed resources.

Dispose(Boolean)

Uvolní nespravované prostředky používané Component a volitelně uvolňuje spravované prostředky.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

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

Asynchronně vynutí objekt příkazu.Asynchronously diposes the command object.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
ExecuteDbDataReader(CommandBehavior)

Při přepsání v odvozené třídě spustí text příkazu proti připojení.When overridden in a derived class, executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Poskytovatelé by měli implementovat tuto metodu, aby poskytovala nevýchozí implementaci pro ExecuteReader přetížení.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Výchozí implementace vyvolá synchronní ExecuteReader() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Výchozí implementace vrátí zrušenou úlohu, je-li předána již zrušený token zrušení.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Výjimky vyvolané funkcí ExecuteReader budou sděleny prostřednictvím vrácené vlastnosti Exception úlohy.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Tato metoda přijímá token zrušení, který lze použít k žádosti o zrušení operace, která bude brzy zrušena.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementace mohou tuto žádost ignorovat.Implementations may ignore this request.

ExecuteNonQuery()

Při přepsání v odvozené třídě spustí příkaz SQL pro objekt připojení.When overridden in a derived class, executes a SQL statement against a connection object.

ExecuteNonQueryAsync()

Asynchronní verze nástroje ExecuteNonQuery() , která spouští příkaz SQL pro objekt připojení.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Vyvolá ExecuteNonQueryAsync(CancellationToken) se s CancellationToken. None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken)

Toto je asynchronní verze ExecuteNonQuery() .This is the asynchronous version of ExecuteNonQuery(). Poskytovatelé by měli přepsat příslušnou implementací.Providers should override with an appropriate implementation. Token zrušení se může volitelně ignorovat.The cancellation token may optionally be ignored.

Výchozí implementace vyvolá synchronní ExecuteNonQuery() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Výchozí implementace vrátí zrušenou úlohu, je-li předána již zrušený token zrušení.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Výjimky vyvolané nástrojem ExecuteNonQuery() budou sděleny přes vrácenou vlastnost Exception úlohy.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Nevolejte jiné metody a vlastnosti DbCommand objektu, dokud není vrácen dokončený úkol.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader()

Provede CommandText Connection a vrátí DbDataReader .Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior)

Provede CommandText Connection a vrátí hodnotu DbDataReader pomocí jedné z CommandBehavior hodnot.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Asynchronní verze nástroje ExecuteReader , která provede příkaz s CommandText Connection a vrátí DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) se s CancellationToken. None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

ExecuteReaderAsync(CancellationToken)

Asynchronní verze nástroje ExecuteReader , která provede příkaz s CommandText Connection a vrátí DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Tato metoda šíří oznámení, že operace by se měly zrušit.This method propagates a notification that operations should be canceled.

Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior)

Asynchronní verze nástroje ExecuteReader , která provede příkaz s CommandText Connection a vrátí DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Vyvolá ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

Při přepsání v odvozené třídě spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vráceným dotazem.When overridden in a derived class, executes the query and returns the first column of the first row in the result set returned by the query. Všechny ostatní sloupce a řádky jsou ignorovány.All other columns and rows are ignored.

ExecuteScalarAsync()

Asynchronní verze ExecuteScalar() , která spustí dotaz a vrátí první sloupec prvního řádku v sadě výsledků dotazu vráceného dotazem.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Všechny ostatní sloupce a řádky jsou ignorovány.All other columns and rows are ignored.

Vyvolá ExecuteScalarAsync(CancellationToken) se s CancellationToken. None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Toto je asynchronní verze ExecuteScalar() .This is the asynchronous version of ExecuteScalar(). Poskytovatelé by měli přepsat příslušnou implementací.Providers should override with an appropriate implementation. Token zrušení se může volitelně ignorovat.The cancellation token may optionally be ignored.

Výchozí implementace vyvolá synchronní ExecuteScalar() metodu a vrátí dokončenou úlohu, která blokuje volající vlákno.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Výchozí implementace vrátí zrušenou úlohu, je-li předána již zrušený token zrušení.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Výjimky vyvolané funkcí ExecuteScalar budou sděleny prostřednictvím vrácené vlastnosti Exception úlohy.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Nevolejte jiné metody a vlastnosti DbCommand objektu, dokud není vrácen dokončený úkol.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

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

Načte aktuální objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Zděděno od MarshalByRefObject)
GetService(Type)

Vrátí objekt, který představuje službu poskytnutou Component nebo podle jeho Container .Returns an object that represents a service provided by the Component or by its Container.

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

Získá Type aktuální instanci.Gets the Type of the current instance.

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

Získá objekt služby životnosti, který řídí zásady životního cyklu pro tuto instanci.Obtains a lifetime service object to control the lifetime policy for this instance.

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

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

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

Vytvoří kopii aktuálního objektu bez podstruktury MarshalByRefObject .Creates a shallow copy of the current MarshalByRefObject object.

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

Při přepsání v odvozené třídě vytvoří na zdroji dat připravený (nebo zkompilovanou) verzi příkazu.When overridden in a derived class, creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken)

Asynchronně vytvoří připravené (nebo kompilované) verze příkazu na zdroji dat.Asynchronously creates a prepared (or compiled) version of the command on the data source.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)
ToString()

Vrátí hodnotu String obsahující název Component , pokud existuje.Returns a String containing the name of the Component, if any. Tato metoda by neměla být přepsána.This method should not be overridden.

(Zděděno od Component)

Události

Disposed

Nastane, pokud je komponenta uvolněna voláním Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Zděděno od Component)

Explicitní implementace rozhraní

IDbCommand.Connection

Získá nebo nastaví IDbConnection použitou tuto instanci IDbCommand .Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter()

Vytvoří novou instanci IDbDataParameter objektu.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader()

Provede CommandText Connection a vytvoří IDataReader .Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Provede CommandText Connection a vytvoří IDataReader pomocí jedné z CommandBehavior hodnot.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters

Získá IDataParameterCollection .Gets the IDataParameterCollection.

IDbCommand.Transaction

Získá nebo nastaví, DbTransaction ve kterém se tento DbCommand objekt spustí.Gets or sets the DbTransaction within which this DbCommand object executes.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, jak se provádí funkce await u úloh vrácených z asynchronního použití.Configures how awaits on the tasks returned from an async disposable are performed.

Platí pro