EntityCommand Klasse

Definition

Stellt einen Befehl für die konzeptionelle Ebene dar.Represents a command for the conceptual layer.

public ref class EntityCommand sealed : System::Data::Common::DbCommand
public sealed class EntityCommand : System.Data.Common.DbCommand
type EntityCommand = class
    inherit DbCommand
Public NotInheritable Class EntityCommand
Inherits DbCommand
Vererbung

Konstruktoren

EntityCommand()

Initialisiert eine neue Instanz der EntityCommand-Klasse unter Verwendung der angegebenen Werte.Initializes a new instance of the EntityCommand class using the specified values.

EntityCommand(String)

Initialisiert eine neue Instanz der EntityCommand-Klasse mit der angegebenen Anweisung.Initializes a new instance of the EntityCommand class with the specified statement.

EntityCommand(String, EntityConnection)

Initialisiert eine neue Instanz der EntityCommand-Klasse mit der angegebenen Anweisung und der Verbindung.Initializes a new instance of the EntityCommand class with the specified statement and connection.

EntityCommand(String, EntityConnection, EntityTransaction)

Initialisiert eine neue Instanz der EntityCommand-Klasse mit der angegebenen Anweisung, Verbindung und Transaktion.Initializes a new instance of the EntityCommand class with the specified statement, connection and transaction.

Eigenschaften

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.

(Geerbt von Component)
CommandText

Ruft eine Entity SQL-Anweisung ab, die einen auszuführenden Befehl oder eine auszuführende gespeicherte Prozedur angibt, oder legt diese fest.Gets or sets an Entity SQL statement that specifies a command or stored procedure to execute.

CommandTimeout

Ruft die Wartezeit bis zum Timeout auf bzw. legt diese fest.Gets or sets the amount of time to wait before timing out.

CommandTree

Ruft die auszuführende Befehlsstruktur ab oder legt diese fest. Es kann entweder die Befehlsstruktur oder der Befehlstext festgelegt werden, nicht beides.Gets or sets the command tree to execute; only one of the command tree or the command text can be set, not both.

CommandType

Ruft einen Wert ab, der angibt, wie die CommandText-Eigenschaft interpretiert werden soll, oder legt diesen fest.Gets or sets a value that indicates how the CommandText property is to be interpreted.

Connection

Ruft die vom EntityConnection verwendete EntityCommand ab oder legt diese fest.Gets or sets the EntityConnection used by the EntityCommand.

Container

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

(Geerbt von Component)
DbConnection

Ruft bei Überschreibung in einer abgeleiteten Klasse die DbConnection-Eigenschaft ab, die für diesen DbCommand verwendet wird.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Geerbt von DbCommand)
DbParameterCollection

Ruft bei Überschreibung in einer abgeleiteten Klasse die Sammlung von DbParameter-Objekten ab.When overridden in a derived class, gets the collection of DbParameter objects.

(Geerbt von DbCommand)
DbTransaction

Ruft bei Überschreibung in einer abgeleiteten Klasse die DbTransaction ab, in der dieses DbCommand-Objekt ausgeführt wird, oder legt diese Transaktion fest.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

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

(Geerbt von Component)
DesignTimeVisible

Ruft einen Wert ab, der angibt, ob das Befehlsobjekt in einem Steuerelement für Windows Forms-Designer sichtbar sein soll, oder legt diesen fest.Gets or sets a value that indicates whether the command object should be visible in a Windows Form Designer control.

EnablePlanCaching

Ruft einen Wert ab, der angibt, ob das Zwischenspeichern von Abfrageplänen aktiviert ist, oder legt den Wert fest.Gets or sets a value that indicates whether the query plan caching is enabled.

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.

(Geerbt von Component)
Parameters

Ruft die Parameter der Entity SQL-Anweisung oder der gespeicherten Prozedur ab.Gets the parameters of the Entity SQL statement or stored procedure.

Site

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

(Geerbt von Component)
Transaction

Übernimmt oder bestimmt die Transaktion, die von SqlCommand ausgeführt wird.Gets or sets the transaction within which the SqlCommand executes.

UpdatedRowSource

Ruft ab oder legt fest, wie Befehlsergebnisse auf zu aktualisierende Zeilen angewendet werden.Gets or sets how command results are applied to rows being updated.

Methoden

Cancel()

Bricht die Ausführung eines EntityCommand ab.Cancels the execution of an EntityCommand.

CreateDbParameter()

Erstellt bei Überschreibung in einer abgeleiteten Klasse eine neue Instanz eines DbParameter-Objekts.When overridden in a derived class, creates a new instance of a DbParameter object.

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

(Geerbt von MarshalByRefObject)
CreateParameter()

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

Dispose() (Geerbt von DbCommand)
Dispose(Boolean) (Geerbt von DbCommand)
DisposeAsync()

Stellt das Befehlsobjekt asynchron bereit.Asynchronously diposes the command object.

(Geerbt von DbCommand)
Equals(Object)

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

(Geerbt von Object)
ExecuteDbDataReader(CommandBehavior)

Führt bei Überschreibung in einer abgeleiteten Klasse den Befehlstext für die Verbindung aus.When overridden in a derived class, executes the command text against the connection.

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

(Geerbt von DbCommand)
ExecuteNonQuery()

Führt den aktuellen Befehl aus.Executes the current command.

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.

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

(Geerbt von DbCommand)
ExecuteReader()

Führt den Befehl aus und gibt einen Datenreader zurück.Executes the command and returns a data reader.

ExecuteReader(CommandBehavior)

Kompiliert den CommandText in eine Befehlsstruktur und übergibt ihn an den zugrunde liegende Speicheranbieter zur Ausführung. Anschließend wird EntityDataReader aus dem erzeugten Resultset mit angegebenen CommandBehavior erstellt.Compiles the CommandText into a command tree and passes it to the underlying store provider for execution, then builds an EntityDataReader out of the produced result set using the specified CommandBehavior.

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.

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

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

(Geerbt von DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

(Geerbt von DbCommand)
ExecuteScalar()

Führt den Befehl aus und gibt die erste Spalte der ersten Zeile im Resultset zurück.Executes the command, and returns the first column of the first row in the result set. Zusätzliche Spalten oder Zeilen werden ignoriert.Additional columns or rows are ignored.

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.

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

(Geerbt von DbCommand)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

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

(Geerbt von Component)
GetType()

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

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

(Geerbt von MarshalByRefObject)
MemberwiseClone()

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

(Geerbt von Object)
MemberwiseClone(Boolean)

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

(Geerbt von MarshalByRefObject)
Prepare()

Kompiliert den Befehl auf Entitätsebene und erstellt eine vorbereitete Version des Befehls.Compiles the entity-level command and creates a prepared version of the command.

PrepareAsync(CancellationToken)

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

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

(Geerbt von Component)
ToTraceString()

Kompiliert den Befehl auf Entitätsebene und gibt den Speicherbefehlstext zurück.Compiles the entity-level command and returns the store command text.

Ereignisse

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.

(Geerbt von Component)

Explizite Schnittstellenimplementierungen

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.

(Geerbt von DbCommand)
IDbCommand.CreateParameter()

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

(Geerbt von DbCommand)
IDbCommand.ExecuteReader()

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

(Geerbt von DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

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

(Geerbt von DbCommand)
IDbCommand.Parameters

Ruft die IDataParameterCollection ab.Gets the IDataParameterCollection.

(Geerbt von DbCommand)
IDbCommand.Transaction

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

(Geerbt von DbCommand)

Gilt für: