DbCommand Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Quelle:

DbCommand.cs

Stellt eine SQL-Anweisung oder gespeicherte Prozedur dar, die für eine Datenquelle ausgeführt werden soll. Stellt eine Basisklasse für datenbankspezifische Klassen bereit, die Befehle darstellen. ExecuteNonQueryAsync.

public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand

public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable

Vererbung

Object

MarshalByRefObject

Component

DbCommand

Abgeleitet

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.SqlClient.SqlCommand

Implementiert

IDisposable IDbCommand IAsyncDisposable

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 Textbefehl ab, der für die Datenquelle ausgeführt werden soll, oder legt diesen fest.
CommandTimeout	Ruft die Wartezeit (in Sekunden) ab, bevor der Versuch, den Befehl auszuführen und einen Fehler zu generieren, beendet wird, oder legt diese fest.
CommandType	Ruft ab oder legt fest, wie die CommandText -Eigenschaft interpretiert wird.
Connection	Dient zum Abrufen oder Festlegen der von diesem DbCommandverwendeten DbConnection.
Container	Ruft die IContainer ab, die den Componententhält. (Geerbt von Component)
DbConnection	Dient zum Abrufen oder Festlegen der von diesem DbCommandverwendeten DbConnection.
DbParameterCollection	Ruft die Auflistung von DbParameter -Objekten ab.
DbTransaction	Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Component derzeit im Entwurfsmodus befindet. (Geerbt von Component)
DesignTimeVisible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Befehlsobjekt in einem angepassten Schnittstellensteuerelement sichtbar sein soll.
Events	Ruft die Liste der Ereignishandler ab, die an diese Componentangefü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	Dient zum Abrufen oder Festlegen des ISite des Component. (Geerbt von Component)
Transaction	Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird.
UpdatedRowSource	Ruft ab oder legt fest, wie Befehlsergebnisse auf die DataRow angewendet werden, wenn sie von der Update -Methode einer DbDataAdapterverwendet wird.

Methoden

Cancel()	Versucht, die Ausführung eines DbCommandabzubrechen.
CreateDbParameter()	Erstellt eine neue Instanz eines DbParameter-Objekts.
CreateObjRef(Type)	Erstellt ein Objekt, das alle relevanten Informationen enthält, die zum Generieren eines Proxys erforderlich sind, der für die Kommunikation mit einem Remoteobjekt verwendet wird. (Geerbt von MarshalByRefObject)
CreateParameter()	Erstellt eine neue Instanz eines DbParameter-Objekts.
Dispose()	Gibt alle vom Componentverwendeten Ressourcen frei. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die vom Component verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component)
DisposeAsync()	Das Befehlsobjekt wird asynchron eingetaucht.
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt eine DbDataReader zurück, die für den Zugriff auf die Ergebnisse verwendet werden kann.
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, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Diese Methode akzeptiert ein Abbruchtoken, mit dem der Vorgang frühzeitig abgebrochen werden kann. Implementierungen können diese Anforderung ignorieren.
ExecuteNonQuery()	Führt den Befehl für sein Verbindungsobjekt aus, wobei die Anzahl der betroffenen Zeilen zurückgegeben wird.
ExecuteNonQueryAsync()	Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für das Verbindungsobjekt ausführt und die Anzahl der betroffenen Zeilen zurückgibt. Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf.
ExecuteNonQueryAsync(CancellationToken)	Dies ist die asynchrone Version von ExecuteNonQuery(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Rufen Sie erst andere 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 für den Zugriff auf die Ergebnisse verwendet werden kann.
ExecuteReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt eine DbDataReader zurück, die für den Zugriff auf die Ergebnisse verwendet werden kann.
ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) mit CancellationToken.None auf.
ExecuteReaderAsync(CancellationToken)	Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)auf.
ExecuteReaderAsync(CommandBehavior)	Eine asynchrone Version von ExecuteReader, die den Befehl für die Verbindung ausführt und eine DbDataReader zurückgibt, die für den Zugriff auf die Ergebnisse verwendet werden kann. 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 Resultsets 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 Resultsets werden ignoriert. Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.
ExecuteScalarAsync(CancellationToken)	Dies ist die asynchrone Version von ExecuteScalar(). Anbieter sollten mit einer geeigneten Implementierung außer Kraft setzen. Das Abbruchtoken kann optional ignoriert werden. Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück, die den aufrufenden Thread blockiert. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn ein bereits abgebrochenes Abbruchtoken übergeben wurde. Ausnahmen, die von ExecuteScalar ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft kommuniziert. Rufen Sie erst andere Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinie für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetService(Type)	Gibt ein Objekt zurück, das einen Dienst darstellt, der vom Component oder von seinem Containerbereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt ab, um die Lebensdauerrichtlinie für diese Instanz zu steuern. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie der 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 in der Datenquelle.
PrepareAsync(CancellationToken)	Erstellt asynchron eine vorbereitete (oder kompilierte) Version des Befehls in der Datenquelle.
ToString()	Gibt einen String zurück, der den Namen der Componententhält, falls vorhanden. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Ereignisse

Disposed

Tritt auf, wenn die Komponente durch einen Aufruf der Dispose() -Methode verworfen wird. (Geerbt von Component)

Explizite Schnittstellenimplementierungen

IDbCommand.Connection	Dient zum Abrufen oder Festlegen der IDbConnection, die von dieser Instanz des IDbCommandverwendet wird.
IDbCommand.CreateParameter()	Erstellt eine neue Instanz eines IDbDataParameter-Objekts.
IDbCommand.ExecuteReader()	Führt die CommandText für die Connection aus und erstellt eine IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Führt den CommandText für den Connectionaus und erstellt eine IDataReader unter Verwendung eines der CommandBehavior Werte.
IDbCommand.Parameters	Ruft die IDataParameterCollectionab.
IDbCommand.Transaction	Dient zum Abrufen oder Festlegen des DbTransaction, in dem dieses DbCommand-Objekt ausgeführt wird.

Erweiterungsmethoden

ConfigureAwait(IAsyncDisposable, Boolean)

Konfiguriert, wie auf die von einem asynchronen Einweg zurückgegebenen Aufgaben gewartet wird.

Weitere Informationen

• ADO.NET Übersicht