Udostępnij za pośrednictwem


DbCommand Klasa

Definicja

Reprezentuje instrukcję SQL lub procedurę składowaną do wykonania względem źródła danych. Udostępnia klasę bazową dla klas specyficznych dla bazy danych, które reprezentują polecenia. 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()

Tworzy wystąpienie obiektu DbCommand.

Właściwości

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.

(Odziedziczone po Component)
CommandText

Pobiera lub ustawia polecenie tekstowe do uruchomienia względem źródła danych.

CommandTimeout

Pobiera lub ustawia czas oczekiwania (w sekundach) przed zakończeniem próby wykonania polecenia i wygenerowaniem błędu.

CommandType

Pobiera lub ustawia sposób interpretowania właściwości CommandText.

Connection

Pobiera lub ustawia DbConnection używane przez ten DbCommand.

Container

Pobiera IContainer, który zawiera Component.

(Odziedziczone po Component)
DbConnection

Pobiera lub ustawia DbConnection używane przez ten DbCommand.

DbParameterCollection

Pobiera kolekcję obiektów DbParameter.

DbTransaction

Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand.

DesignMode

Pobiera wartość wskazującą, czy Component jest obecnie w trybie projektowania.

(Odziedziczone po Component)
DesignTimeVisible

Pobiera lub ustawia wartość wskazującą, czy obiekt polecenia powinien być widoczny w dostosowanej kontrolce interfejsu.

Events

Pobiera listę programów obsługi zdarzeń dołączonych do tej Component.

(Odziedziczone po Component)
Parameters

Pobiera kolekcję obiektów DbParameter. Aby uzyskać więcej informacji na temat parametrów, zobacz Konfigurowanie parametrów i typów danych parametrów.

Site

Pobiera lub ustawia ISiteComponent.

(Odziedziczone po Component)
Transaction

Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand.

UpdatedRowSource

Pobiera lub ustawia sposób stosowania wyników poleceń do DataRow w przypadku użycia przez metodę Update DbDataAdapter.

Metody

Cancel()

Próbuje anulować wykonywanie DbCommand.

CreateDbParameter()

Tworzy nowe wystąpienie obiektu DbParameter.

CreateObjRef(Type)

Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym.

(Odziedziczone po MarshalByRefObject)
CreateParameter()

Tworzy nowe wystąpienie obiektu DbParameter.

Dispose()

Wykonuje zadania zdefiniowane przez aplikację skojarzone z zwalnianiem, wydawaniem lub resetowaniem niezarządzanych zasobów.

Dispose()

Zwalnia wszystkie zasoby używane przez Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez DbCommand i opcjonalnie zwalnia zarządzane zasoby.

Dispose(Boolean)

Zwalnia niezarządzane zasoby używane przez Component i opcjonalnie zwalnia zarządzane zasoby.

(Odziedziczone po Component)
DisposeAsync()

Asynchronicznie diposuje obiekt polecenia.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.

(Odziedziczone po Object)
ExecuteDbDataReader(CommandBehavior)

Wykonuje polecenie względem jego połączenia, zwracając DbDataReader, które mogą służyć do uzyskiwania dostępu do wyników.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Dostawcy powinni zaimplementować tę metodę, aby zapewnić implementację inną niż domyślna dla przeciążeń ExecuteReader.

Domyślna implementacja wywołuje synchroniczną metodę ExecuteReader() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteReader będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Ta metoda akceptuje token anulowania, który może służyć do żądania wcześniejszego anulowania operacji. Implementacje mogą ignorować to żądanie.

ExecuteNonQuery()

Wykonuje polecenie względem jego obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem.

ExecuteNonQueryAsync()

Asynchroniczna wersja ExecuteNonQuery(), która wykonuje polecenie względem jego obiektu połączenia, zwracając liczbę wierszy, których dotyczy problem.

Wywołuje ExecuteNonQueryAsync(CancellationToken) z elementem CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken)

Jest to asynchroniczna wersja ExecuteNonQuery(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje synchroniczną metodę ExecuteNonQuery() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez ExecuteNonQuery() będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Nie należy wywoływać innych metod i właściwości obiektu DbCommand, dopóki zwrócone zadanie nie zostanie ukończone.

ExecuteReader()

Wykonuje polecenie względem jego połączenia, zwracając DbDataReader, które mogą służyć do uzyskiwania dostępu do wyników.

ExecuteReader(CommandBehavior)

Wykonuje polecenie względem jego połączenia, zwracając DbDataReader, które mogą służyć do uzyskiwania dostępu do wyników.

ExecuteReaderAsync()

Asynchroniczna wersja ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając DbDataReader, który może służyć do uzyskiwania dostępu do wyników.

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

ExecuteReaderAsync(CancellationToken)

Asynchroniczna wersja ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając DbDataReader, który może służyć do uzyskiwania dostępu do wyników.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior)

Asynchroniczna wersja ExecuteReader, która wykonuje polecenie względem jego połączenia, zwracając DbDataReader, który może służyć do uzyskiwania dostępu do wyników.

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Wywołuje ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar()

Wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.

ExecuteScalarAsync()

Asynchroniczna wersja ExecuteScalar(), która wykonuje polecenie i zwraca pierwszą kolumnę pierwszego wiersza w pierwszym zwróconym zestawie wyników. Wszystkie inne kolumny, wiersze i zestawy wyników są ignorowane.

Wywołuje ExecuteScalarAsync(CancellationToken) z elementem CancellationToken.None.

ExecuteScalarAsync(CancellationToken)

Jest to asynchroniczna wersja ExecuteScalar(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania może być opcjonalnie ignorowany.

Domyślna implementacja wywołuje synchroniczną metodę ExecuteScalar() i zwraca ukończone zadanie, blokując wątek wywołujący. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowany token anulowania. Wyjątki zgłaszane przez element ExecuteScalar będą przekazywane za pośrednictwem zwróconej właściwości Wyjątku zadania.

Nie należy wywoływać innych metod i właściwości obiektu DbCommand, dopóki zwrócone zadanie nie zostanie ukończone.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetLifetimeService()
Przestarzałe.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt reprezentujący usługę dostarczaną przez Component lub Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżącego wystąpienia.

(Odziedziczone po Object)
InitializeLifetimeService()
Przestarzałe.

Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy płytkią kopię bieżącego obiektu MarshalByRefObject.

(Odziedziczone po MarshalByRefObject)
Prepare()

Tworzy przygotowaną (lub skompilowana) wersję polecenia w źródle danych.

PrepareAsync(CancellationToken)

Asynchronicznie tworzy przygotowaną (lub skompilowana) wersję polecenia w źródle danych.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
ToString()

Zwraca String zawierającą nazwę Component, jeśli istnieje. Ta metoda nie powinna być zastępowana.

(Odziedziczone po Component)

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie metody Dispose().

(Odziedziczone po Component)

Jawne implementacje interfejsu

IDbCommand.Connection

Pobiera lub ustawia IDbConnection używane przez to wystąpienie IDbCommand.

IDbCommand.CreateParameter()

Tworzy nowe wystąpienie obiektu IDbDataParameter.

IDbCommand.ExecuteReader()

Wykonuje CommandText względem Connection i tworzy IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Wykonuje CommandText względem Connectioni tworzy IDataReader przy użyciu jednej z wartości CommandBehavior.

IDbCommand.Parameters

Pobiera IDataParameterCollection.

IDbCommand.Transaction

Pobiera lub ustawia DbTransaction, w którym jest wykonywany ten obiekt DbCommand.

Metody rozszerzania

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguruje, w jaki sposób będą wykonywane oczekiwania na zadania zwrócone z asynchronicznego jednorazowego użytku.

Dotyczy

Zobacz też