DbCommand Klasse

Definition

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 : 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 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()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freigeben oder Zurücksetzen nicht verwalteter Ressourcen verknüpft sind.

Dispose()

Gibt alle vom Componentverwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die nicht verwalteten Ressourcen frei, die vom DbCommand verwendet werden, und gibt optional die verwalteten Ressourcen frei.

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 eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
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.

Gilt für:

Weitere Informationen