DbCommand Klasse

Definition

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die in einer Datenquelle ausgeführt werden soll. Stellt eine Basisklasse für datenbankspezifische Klassen bereit, die Befehle darstellen. 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
Vererbung
DbCommand
Vererbung
Abgeleitet
Implementiert

Konstruktoren

DbCommand()

Erstellt eine Instanz des DbCommand-Objekts.

Eigenschaften

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
CommandText

Ruft den für die Datenquelle auszuführenden Textbefehl ab bzw. legt ihn fest.

CommandTimeout

Ruft die Wartezeit (in Sekunden) ab oder legt sie fest, bevor der Versuch beendet wird, den Befehl auszuführen und einen Fehler zu generieren.

CommandType

Ruft ab oder legt fest, wie die CommandText Eigenschaft interpretiert wird.

Connection

Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest.

Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
DbConnection

Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest.

DbParameterCollection

Ruft die Auflistung von DbParameter-Objekten ab.

DbTransaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.

DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
DesignTimeVisible

Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Schnittstellensteuerelement sichtbar sein soll, oder legt diesen fest.

Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
Parameters

Ruft die Auflistung von DbParameter-Objekten ab. Weitere Informationen zu Parametern finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.

UpdatedRowSource

Ruft ab oder legt fest, wie die Ergebnisse von Befehlen auf DataRow angewendet werden, wenn diese von der Update-Methode eines DbDataAdapter verwendet wird.

Methoden

Cancel()

Versucht, die Ausführung einer DbCommand.

CreateDbParameter()

Erstellt eine neue Instanz eines DbParameter-Objekts.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
CreateParameter()

Erstellt eine neue Instanz eines DbParameter-Objekts.

Dispose()

Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.

Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von DbCommand verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von Component)
DisposeAsync()

Stellt das Befehlsobjekt asynchron bereit.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)

Führt den Befehl gegen seine Verbindung aus, und gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader-Überladungen bereitzustellen.

Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern. Implementierungen können diese Anforderung ignorieren.

ExecuteNonQuery()

Führt den Befehl gegen sein Verbindungsobjekt aus, und gibt die Anzahl der betroffenen Zeilen zurück.

ExecuteNonQueryAsync()

Eine asynchrone Version von ExecuteNonQuery(), die den Befehl gegen das Verbindungsobjekt ausführt, gibt die Anzahl der betroffenen Zeilen zurück.

Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf.

ExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.

ExecuteReader()

Führt den Befehl für seine Verbindung aus, und gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.

ExecuteReader(CommandBehavior)

Führt den Befehl für seine Verbindung aus, und gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.

ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt, gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) mit CancellationToken.None auf.

ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt, gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.

ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt, gibt eine DbDataReader zurück, die verwendet werden kann, um auf die Ergebnisse zuzugreifen.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.

ExecuteScalar()

Führt den Befehl aus und gibt die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurück. Alle anderen Spalten, Zeilen und Ergebnissätze werden ignoriert.

ExecuteScalarAsync()

Eine asynchrone Version von ExecuteScalar(), die den Befehl ausführt und die erste Spalte der ersten Zeile im ersten zurückgegebenen Resultset zurückgibt. Alle anderen Spalten, Zeilen und Ergebnissätze werden ignoriert.

Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.

ExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben. Das Abbruchtoken kann optional ignoriert werden.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.

PrepareAsync(CancellationToken)

Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.

ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden). Diese Methode darf nicht überschrieben werden.

(Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

IDbCommand.Connection

Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest.

IDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter -Objekts.

IDbCommand.ExecuteReader()

Führt den CommandText für die Connection aus und erstellt einen IDataReader.

IDbCommand.ExecuteReader(CommandBehavior)

Führt CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior.

IDbCommand.Parameters

Ruft das IDataParameterCollection ab.

IDbCommand.Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt sie fest.

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie Wartezeiten auf die Aufgaben angewandt werden, die von einem asynchronen verwerfbaren Element zurückgegeben werden.

Gilt für:

Siehe auch