DbCommand Klasse

Referenz

Definition

Namespace:: System.Data.Common

Assembly:: System.Data.Common.dll

Assembly:: System.Data.dll

Assembly:: netstandard.dll

Quelle:: DbCommand.cs

Quelle:: DbCommand.cs

Quelle:: DbCommand.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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: Object
DbCommand

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 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 für die Datenquelle auszuführenden Textbefehl ab bzw. legt ihn fest.
CommandTimeout	Ruft die Wartezeit (in Sekunden) ab, bevor der Versuch beendet wird, den Befehl auszuführen und einen Fehler zu generieren, oder legt diese fest.
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 eines DbCommandabzubrechen.
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 für seine Verbindung aus und gibt einen zurück DbDataReader , der 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. 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 für sein Verbindungsobjekt aus und gibt die Anzahl der betroffenen Zeilen zurück.
ExecuteNonQueryAsync()	Eine asynchrone Version von ExecuteNonQuery(), die den Befehl für sein 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 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 einen zurück DbDataReader , der für den Zugriff auf die Ergebnisse verwendet werden kann.
ExecuteReader(CommandBehavior)	Führt den Befehl für seine Verbindung aus und gibt einen zurück DbDataReader , der 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 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 seine 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 seine 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 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:

Weitere Informationen

Übersicht über ADO.NET