DbCommand Klasse

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.dll

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, IDisposable, System::Data::IDbCommand

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

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IDbCommand, IDisposable

Vererbung

Object

MarshalByRefObject

Component

DbCommand

Abgeleitet

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.OracleClient.OracleCommand

System.Data.SqlClient.SqlCommand

Implementiert

IDisposable IDbCommand

Konstruktoren

Name	Beschreibung
DbCommand()	Erstellt eine Instanz des DbCommand Objekts.

Eigenschaften

Name	Beschreibung
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 DbConnection von diesem DbCommandverwendeten .
Container	Ruft das, das IContainer die Component. (Geerbt von Component)
DbConnection	Dient zum Abrufen oder Festlegen der DbConnection von diesem DbCommandverwendeten .
DbParameterCollection	Ruft die Auflistung von -Objekten ab DbParameter .
DbTransaction	Dient zum Abrufen oder Festlegen des DbTransaction Objekts, in dem dieses DbCommand Objekt ausgeführt wird.
DesignMode	Ruft einen Wert ab, der angibt, ob sich der Component Entwurfsmodus derzeit 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 -Objekten ab DbParameter . 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	Dient zum Abrufen oder Festlegen des DbTransaction Objekts, in dem dieses DbCommand Objekt ausgeführt wird.
UpdatedRowSource	Ruft ab oder legt fest, wie Befehlsergebnisse angewendet DataRow werden, wenn von der Update -Methode einer DbDataAdapter.

Methoden

Name	Beschreibung
Cancel()	Versucht, die Ausführung einer .DbCommand
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()	Veröffentlicht alle ressourcen, die von der Component. (Geerbt von Component)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den Component verwalteten Ressourcen verwendet werden, und gibt optional die verwalteten Ressourcen frei. (Geerbt von Component)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt ein DbDataReader Element zurück, das 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 ausgelöst ExecuteNonQuery() werden, werden über die zurückgegebene Task Exception-Eigenschaft mitgeteilt. Rufen Sie erst andere Methoden und Eigenschaften des DbCommand Objekts auf, wenn die zurückgegebene Aufgabe abgeschlossen ist.
ExecuteReader()	Führt den Befehl für seine Verbindung aus und gibt ein DbDataReader Element zurück, das für den Zugriff auf die Ergebnisse verwendet werden kann.
ExecuteReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt ein DbDataReader Element zurück, das für den Zugriff auf die Ergebnisse verwendet werden kann.
ExecuteReaderAsync()	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt, gibt ein DbDataReader , das 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 seine Verbindung ausführt, gibt ein DbDataReader , das für den Zugriff auf die Ergebnisse verwendet werden kann. Aufrufe ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Aufrufe ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior)	Eine asynchrone Version von ExecuteReader, die den Befehl für seine Verbindung ausführt, gibt ein DbDataReader , das für den Zugriff auf die Ergebnisse verwendet werden kann. Aufrufe ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
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, wenn die zurückgegebene Aufgabe abgeschlossen ist.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	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 von der Component oder dem zugehörigen ContainerDienst bereitgestellt wird. (Geerbt von Component)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	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.
ToString()	Gibt einen String mit dem Namen des Component, falls vorhanden, zurück. Diese Methode sollte nicht außer Kraft gesetzt werden. (Geerbt von Component)

Ereignisse

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

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDbCommand.Connection	Dient zum Abrufen oder Festlegen der IDbConnection von dieser Instanz der IDbCommand.
IDbCommand.CreateParameter()	Erstellt eine neue Instanz eines IDbDataParameter Objekts.
IDbCommand.ExecuteReader()	Führt die CommandText gegen die Connection und erstellt eine IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Führt den CommandText Gegenwert Connectionaus und erstellt einen IDataReader mit einem der CommandBehavior Werte.
IDbCommand.Parameters	Ruft IDataParameterCollection ab.
IDbCommand.Transaction	Dient zum Abrufen oder Festlegen des DbTransaction Objekts, in dem dieses DbCommand Objekt ausgeführt wird.

Weitere Informationen

• Übersicht über ADO.NET