DbCommand Klasa

Definicja

Reprezentuje instrukcję SQL lub procedurę składowaną, która ma zostać wykonana względem źródła danych.Represents an SQL statement or stored procedure to execute against a data source. Udostępnia klasę bazową dla klas specyficznych dla bazy danych, które reprezentują polecenia.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
Dziedziczenie
DbCommand
Dziedziczenie
Pochodne
Implementuje

Konstruktory

DbCommand()

Konstruuje wystąpienie DbCommand obiektu.Constructs an instance of the DbCommand object.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
CommandText

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia polecenie tekstowe do uruchomienia względem źródła danych.When overridden in a derived class, gets or sets the text command to run against the data source.

CommandTimeout

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania polecenia i wygenerowania błędu.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

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia sposób CommandText interpretacji właściwości.When overridden in a derived class, gets or sets how the CommandText property is interpreted.

Connection

Pobiera lub ustawia DbConnection używane przez ten program DbCommand .Gets or sets the DbConnection used by this DbCommand.

Container

Pobiera IContainer , który zawiera Component .Gets the IContainer that contains the Component.

(Odziedziczone po Component)
DbConnection

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia DbConnection używane przez nią DbCommand .When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

DbParameterCollection

Gdy jest zastępowany w klasie pochodnej, pobiera kolekcję DbParameter obiektów.When overridden in a derived class, gets the collection of DbParameter objects.

DbTransaction

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia, DbTransaction w ramach którego jest DbCommand wykonywany ten obiekt.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode

Pobiera wartość wskazującą, czy Component jest aktualnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
DesignTimeVisible

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanym formancie interfejsu.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

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego elementu Component .Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
Parameters

Pobiera kolekcję DbParameter obiektów.Gets the collection of DbParameter objects. Aby uzyskać więcej informacji na temat parametrów, zobacz Konfigurowanie parametrów i typów danych parametrów.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site

Pobiera lub ustawia wartość ISite Component .Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Transaction

Pobiera lub ustawia wartość, DbTransaction w ramach której jest DbCommand wykonywany ten obiekt.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource

Gdy jest zastępowany w klasie pochodnej, Pobiera lub ustawia sposób, w jaki wyniki poleceń są stosowane do obiektu, który jest DataRow używany przez metodę Update obiektu 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()

Gdy jest zastępowany w klasie pochodnej, próbuje anulować wykonanie DbCommand .When overridden in a derived class, attempts to cancel the execution of a DbCommand.

CreateDbParameter()

Gdy jest zastępowany w klasie pochodnej, tworzy nowe wystąpienie DbParameter obiektu.When overridden in a derived class, creates a new instance of a DbParameter object.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
CreateParameter()

Tworzy nowe wystąpienie DbParameter obiektu.Creates a new instance of a DbParameter object.

Dispose()

Wykonuje zdefiniowane przez aplikację zadania skojarzone ze zwalnianiem lub resetowaniem zasobów niezarządzanych.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element DbCommand i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the DbCommand and optionally releases the managed resources.

Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie nakłada obiekt polecenia.Asynchronously diposes the command object.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)

Gdy jest zastępowany w klasie pochodnej, wykonuje tekst polecenia względem połączenia.When overridden in a derived class, executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Dostawcy powinni zaimplementować tę metodę, aby zapewnić implementację niedomyślną dla ExecuteReader przeciążenia.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Implementacja domyślna wywołuje metodę synchroniczną ExecuteReader() i zwraca ukończone zadanie, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteReader będą przekazywane przy użyciu zwróconej właściwości wyjątku zadania.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Ta metoda akceptuje token anulowania, którego można użyć do żądania wcześniejszego anulowania operacji.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementacje mogą zignorować to żądanie.Implementations may ignore this request.

ExecuteNonQuery()

Gdy jest zastępowany w klasie pochodnej, wykonuje instrukcję SQL względem obiektu Connection.When overridden in a derived class, executes a SQL statement against a connection object.

ExecuteNonQueryAsync()

Asynchroniczna wersja ExecuteNonQuery() , która wykonuje instrukcję SQL względem obiektu połączenia.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Wywołuje ExecuteNonQueryAsync(CancellationToken) z CancellationToken. None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken)

Jest to asynchroniczna wersja programu ExecuteNonQuery() .This is the asynchronous version of ExecuteNonQuery(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania może być opcjonalnie ignorowany.The cancellation token may optionally be ignored.

Implementacja domyślna wywołuje metodę synchroniczną ExecuteNonQuery() i zwraca ukończone zadanie, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteNonQuery() program będą przekazywane przez zwracaną Właściwość wyjątku zadania.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości DbCommand obiektu do momentu zakończenia zwracanego zadania.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader()

Wykonuje CommandText Connection polecenie względem i zwraca DbDataReader .Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior)

Wykonuje CommandText Connection polecenie względem i zwraca wartość DbDataReader przy użyciu jednej z CommandBehavior wartości.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync()

Asynchroniczna wersja ExecuteReader , która wykonuje polecenie CommandText względem Connection i zwraca DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) z CancellationToken. None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja ExecuteReader , która wykonuje polecenie CommandText względem Connection i zwraca DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Ta metoda propaguje powiadomienie, że operacje powinny być anulowane.This method propagates a notification that operations should be canceled.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja ExecuteReader , która wykonuje polecenie CommandText względem Connection i zwraca DbDataReader .An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) .Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

Gdy jest zastępowany w klasie pochodnej, wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie.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. Wszystkie inne kolumny i wiersze są ignorowane.All other columns and rows are ignored.

ExecuteScalarAsync()

Asynchroniczna wersja ExecuteScalar() , która wykonuje zapytanie i zwraca pierwszą kolumnę pierwszego wiersza w zestawie wyników zwróconym przez zapytanie.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. Wszystkie inne kolumny i wiersze są ignorowane.All other columns and rows are ignored.

Wywołuje ExecuteScalarAsync(CancellationToken) z CancellationToken. None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Jest to asynchroniczna wersja programu ExecuteScalar() .This is the asynchronous version of ExecuteScalar(). Dostawcy powinny zastępować odpowiednie implementacje.Providers should override with an appropriate implementation. Token anulowania może być opcjonalnie ignorowany.The cancellation token may optionally be ignored.

Implementacja domyślna wywołuje metodę synchroniczną ExecuteScalar() i zwraca ukończone zadanie, blokując wątek wywołujący.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazał już anulowane tokeny anulowania.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Wyjątki zgłoszone przez ExecuteScalar będą przekazywane przy użyciu zwróconej właściwości wyjątku zadania.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Nie wywołuj innych metod i właściwości DbCommand obiektu do momentu zakończenia zwracanego zadania.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub przez Container .Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
Prepare()

Gdy jest zastępowany w klasie pochodnej, tworzy przygotowaną (lub skompilowaną) wersję polecenia w źródle danych.When overridden in a derived class, creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken)

Asynchronicznie tworzy przygotowaną (lub skompilowaną) wersję polecenia w źródle danych.Asynchronously creates a prepared (or compiled) version of the command on the data source.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
ToString()

Zwraca wartość String zawierającą nazwę Component (jeśli istnieje).Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)

Jawne implementacje interfejsu

IDbCommand.Connection

Pobiera lub ustawia IDbConnection używane przez to wystąpienie elementu IDbCommand .Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter()

Tworzy nowe wystąpienie IDbDataParameter obiektu.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader()

Wykonuje w CommandText odniesieniu do Connection i kompiluje IDataReader .Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje CommandText Connection polecenie względem i kompiluje IDataReader przy użyciu jednej z CommandBehavior wartości.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters

Pobiera klasę IDataParameterCollection.Gets the IDataParameterCollection.

IDbCommand.Transaction

Pobiera lub ustawia wartość, DbTransaction w ramach której jest DbCommand wykonywany ten obiekt.Gets or sets the DbTransaction within which this DbCommand object executes.

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Określa, jak oczekują oczekiwania na zadania zwracane z asynchronicznej operacji tworzenia.Configures how awaits on the tasks returned from an async disposable are performed.

Dotyczy