DbCommand DbCommand DbCommand DbCommand Class

Definition

Stellt eine SQL-Anweisung oder eine gespeicherte Prozedur dar, die für eine Datenquelle ausgeführt werden soll.Represents an SQL statement or stored procedure to execute against a data source. Stellt eine Basisklasse für datenbankspezifische Klassen bereit, die Befehle darstellen.Provides a base class for database-specific classes that represent commands. 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
Abgeleitet
Implementiert

Konstruktoren

DbCommand() DbCommand() DbCommand() DbCommand()

Erstellt eine Instanz des DbCommand-Objekts.Constructs an instance of the DbCommand object.

Eigenschaften

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
CommandText CommandText CommandText CommandText

Ruft den Textbefehl ab, der für die Datenquelle ausgeführt werden soll, oder legt diesen fest.Gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

Ruft die Zeit ab, die gewartet werden soll, bis der Versuch einer Befehlsausführung beendet und ein Fehler generiert wird, oder legt diese fest.Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

Gibt an, wie die CommandText-Eigenschaft interpretiert wird.Indicates or specifies how the CommandText property is interpreted.

Connection Connection Connection Connection

Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest.Gets or sets the DbConnection used by this DbCommand.

Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
DbConnection DbConnection DbConnection DbConnection

Ruft die von diesem DbConnection verwendete DbCommand ab oder legt diese fest.Gets or sets the DbConnection used by this DbCommand.

DbParameterCollection DbParameterCollection DbParameterCollection DbParameterCollection

Ruft die Auflistung von DbParameter-Objekten ab.Gets the collection of DbParameter objects.

DbTransaction DbTransaction DbTransaction DbTransaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt diese fest.Gets or sets the DbTransaction within which this DbCommand object executes.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible DesignTimeVisible

Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem benutzerdefinierten Schnittstellensteuerelement sichtbar sein soll, oder legt diesen fest.Gets or sets a value indicating whether the command object should be visible in a customized interface control.

Events Events Events Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Parameters Parameters Parameters Parameters

Ruft die Auflistung von DbParameter-Objekten ab.Gets the collection of DbParameter objects. Weitere Informationen zu Parametern finden Sie unter Konfigurieren von Parametern und Parameterdatentypen.For more information on parameters, see Configuring Parameters and Parameter Data Types.

Site Site Site Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Inherited from Component)
Transaction Transaction Transaction Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt diese fest.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource 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.Gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

Methoden

Cancel() Cancel() Cancel() Cancel()

Versucht die Ausführung eines DbCommand abzubrechen.Attempts to cancels the execution of a DbCommand.

CreateDbParameter() CreateDbParameter() CreateDbParameter() CreateDbParameter()

Erstellt eine neue Instanz eines DbParameter-Objekts.Creates a new instance of a DbParameter object.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

Erstellt eine neue Instanz eines DbParameter-Objekts.Creates a new instance of a DbParameter object.

Dispose() Dispose() Dispose() Dispose()
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)
DisposeAsync() DisposeAsync() DisposeAsync() DisposeAsync()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior) ExecuteDbDataReader(CommandBehavior)

Führt den Befehlstext für die Verbindung aus.Executes the command text against the connection.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

Anbieter sollten diese Methode implementieren, um eine nicht standardmäßige Implementierung für ExecuteReader-Überladungen bereitzustellen.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Die Standardimplementierung ruft die synchrone ExecuteReader()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Diese Methode nimmt ein Abbruchtoken an, das verwendet werden kann, um ein frühes Abbrechen des Vorgangs anzufordern.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementierungen können diese Anforderung ignorieren.Implementations may ignore this request.

ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Führt eine SQL-Anweisung für ein ein Verbindungsobjekt aus.Executes a SQL statement against a connection object.

ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync() ExecuteNonQueryAsync()

Eine asynchrone Version von ExecuteNonQuery(), die eine SQL-Anweisung für ein Verbindungsobjekt ausführt.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Ruft ExecuteNonQueryAsync(CancellationToken) mit CancellationToken.None auf.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken) ExecuteNonQueryAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional ignoriert werden.The cancellation token may optionally be ignored.

Die Standardimplementierung ruft die synchrone ExecuteNonQuery()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteNonQuery() ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

Führt CommandText für die Connection aus und gibt einen DbDataReader zurück.Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

Führt CommandText für die Connection aus und gibt einen DbDataReader mit einem der CommandBehavior-Werte zurück.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync() ExecuteReaderAsync()

Eine asynchrone Version von ExecuteReader, die CommandText gegen Connection ausführt und DbDataReader zurückgibt.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

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

ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken) ExecuteReaderAsync(CancellationToken)

Eine asynchrone Version von ExecuteReader, die CommandText gegen Connection ausführt und DbDataReader zurückgibt.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Diese Methode gibt eine Benachrichtigung darüber weiter, dass Vorgänge abgebrochen werden sollen.This method propagates a notification that operations should be canceled.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior) ExecuteReaderAsync(CommandBehavior)

Eine asynchrone Version von ExecuteReader, die CommandText gegen Connection ausführt und DbDataReader zurückgibt.An asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken) ExecuteReaderAsync(CommandBehavior, CancellationToken)

Ruft ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) auf.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

ExecuteScalar() ExecuteScalar() ExecuteScalar() ExecuteScalar()

Führt die Abfrage aus und gibt die erste Spalte der ersten Zeile im Resultset zurück, das durch die Abfrage zurückgegeben wird.Executes the query and returns the first column of the first row in the result set returned by the query. Alle anderen Spalten und Zeilen werden ignoriert.All other columns and rows are ignored.

ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync() ExecuteScalarAsync()

Eine asynchrone Version von ExecuteScalar(), die die Abfrage ausführt und die erste Spalte der ersten Zeile im Resultset zurückgibt.An asynchronous version of ExecuteScalar(), which executes the query and returns the first column of the first row in the result set returned by the query. Alle anderen Spalten und Zeilen werden ignoriert.All other columns and rows are ignored.

Ruft ExecuteScalarAsync(CancellationToken) mit CancellationToken.None auf.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken) ExecuteScalarAsync(CancellationToken)

Dies ist die asynchrone Version von ExecuteScalar().This is the asynchronous version of ExecuteScalar(). Anbieter sollten mit einer entsprechenden Implementierung überschreiben.Providers should override with an appropriate implementation. Das Abbruchtoken kann optional ignoriert werden.The cancellation token may optionally be ignored.

Die Standardimplementierung ruft die synchrone ExecuteScalar()-Methode auf und gibt eine abgeschlossene Aufgabe zurück. Der aufrufende Thread wird blockiert.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. Die Standardimplementierung gibt eine abgebrochene Aufgabe zurück, wenn sie einen bereits abgebrochenen Abbruchtoken erhalten hat.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Die Ausnahmen, die von ExecuteReader ausgelöst werden, werden über die zurückgegebene Task Exception-Eigenschaft übermittelt.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Rufen Sie keine anderen Methoden und Eigenschaften des DbCommand-Objekts auf, bis die zurückgegebene Aufgabe abgeschlossen ist.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() Prepare()

Erstellt eine vorbereitete (oder kompilierte) Version des Befehls für die Datenquelle.Creates a prepared (or compiled) version of the command on the data source.

PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken) PrepareAsync(CancellationToken)
ToString() ToString() ToString() ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Inherited from Component)

Explizite Schnittstellenimplementierungen

IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection IDbCommand.Connection

Ruft die IDbConnection ab, die von dieser Instanz des IDbCommand verwendet wird, oder legt diese fest.Gets or sets the IDbConnection used by this instance of the IDbCommand.

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()

Erstellt eine neue Instanz eines IDbDataParameter-Objekts.Creates a new instance of an IDbDataParameter object.

IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

Führt CommandText für die Connection aus und erstellt einen IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

Führt CommandText für die Connection aus und erstellt mit einem der IDataReader-Werte einen CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters IDbCommand.Parameters

Ruft die IDataParameterCollection ab.Gets the IDataParameterCollection.

IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction IDbCommand.Transaction

Ruft die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt diese fest.Gets or sets the DbTransaction within which this DbCommand object executes.

Ereignisse

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Gilt für:

Siehe auch