EntityCommand Classe

Definizione

Rappresenta un comando per il livello concettuale.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
Ereditarietà

Costruttori

EntityCommand()

Inizializza una nuova istanza della classe EntityCommand usando i valori specificati.Initializes a new instance of the EntityCommand class using the specified values.

EntityCommand(String)

Inizializza una nuova istanza della classe EntityCommand con l'istruzione specificata.Initializes a new instance of the EntityCommand class with the specified statement.

EntityCommand(String, EntityConnection)

Inizializza una nuova istanza della classe EntityCommand con l'istruzione e la connessione specificati.Initializes a new instance of the EntityCommand class with the specified statement and connection.

EntityCommand(String, EntityConnection, EntityTransaction)

Inizializza una nuova istanza della classe EntityCommand con l'istruzione, la connessione e la transazione specificati.Initializes a new instance of the EntityCommand class with the specified statement, connection and transaction.

Proprietà

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
CommandText

Ottiene o imposta un'istruzione Entity SQL che specifica un comando o una stored procedure da eseguire.Gets or sets an Entity SQL statement that specifies a command or stored procedure to execute.

CommandTimeout

Ottiene o imposta il tempo di attesa prima del timeout.Gets or sets the amount of time to wait before timing out.

CommandTree

Ottiene o imposta l'albero dei comandi da eseguire; è possibile impostare solo l'albero dei comandi o il testo del comando, non entrambi.Gets or sets the command tree to execute; only one of the command tree or the command text can be set, not both.

CommandType

Ottiene o imposta un valore che indica come viene interpretata la proprietà CommandText.Gets or sets a value that indicates how the CommandText property is to be interpreted.

Connection

Ottiene o imposta l'oggetto EntityConnection utilizzato dall'oggetto EntityCommand.Gets or sets the EntityConnection used by the EntityCommand.

Container

Ottiene l'oggetto IContainer che contiene Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
DbConnection

In caso di override in una classe derivata, ottiene o imposta la DbConnection usata da questo DbCommand.When overridden in a derived class, gets or sets the DbConnection used by this DbCommand.

(Ereditato da DbCommand)
DbParameterCollection

In caso di override in una classe derivata, ottiene la raccolta di oggetti DbParameter.When overridden in a derived class, gets the collection of DbParameter objects.

(Ereditato da DbCommand)
DbTransaction

In caso di override in una classe derivata, ottiene o imposta la DbTransaction all'interno della quale viene eseguito questo oggetto DbCommand.When overridden in a derived class, gets or sets the DbTransaction within which this DbCommand object executes.

(Ereditato da DbCommand)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
DesignTimeVisible

Ottiene o imposta un valore che indica se l'oggetto comando deve essere visibile in un controllo Progettazione Windows Form.Gets or sets a value that indicates whether the command object should be visible in a Windows Form Designer control.

EnablePlanCaching

Ottiene o imposta un valore che indica se la memorizzazione nella cache dei piani di query è abilitata.Gets or sets a value that indicates whether the query plan caching is enabled.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
Parameters

Ottiene i parametri dell'istruzione Entity SQL o della stored procedure.Gets the parameters of the Entity SQL statement or stored procedure.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Transaction

Ottiene o imposta la transazione all'interno della quale SqlCommand viene eseguito.Gets or sets the transaction within which the SqlCommand executes.

UpdatedRowSource

Ottiene o imposta la modalità di applicazione dei risultati del comando alle righe che vengono aggiornate.Gets or sets how command results are applied to rows being updated.

Metodi

Cancel()

Annulla l'esecuzione di EntityCommand.Cancels the execution of an EntityCommand.

CreateDbParameter()

In caso di override in una classe derivata, crea una nuova istanza di un oggetto DbParameter.When overridden in a derived class, creates a new instance of a DbParameter object.

(Ereditato da DbCommand)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
CreateParameter()

Crea una nuova istanza di un oggetto EntityParameter .Creates a new instance of an EntityParameter object.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Ereditato da DbCommand)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DbCommand e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the DbCommand and optionally releases the managed resources.

(Ereditato da DbCommand)
DisposeAsync()

Elimina in modo asincrono l'oggetto comando.Asynchronously diposes the command object.

(Ereditato da DbCommand)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
ExecuteDbDataReader(CommandBehavior)

In caso di override in una classe derivata, esegue il testo del comando sulla connessione.When overridden in a derived class, executes the command text against the connection.

(Ereditato da DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

I provider devono implementare questo metodo per fornire un'implementazione non predefinita per gli overload di ExecuteReader .Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

L'implementazione predefinita richiama il metodo sincrono ExecuteReader() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Le eccezioni generate da ExecuteReader verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Le implementazioni possono ignorare la richiesta.Implementations may ignore this request.

(Ereditato da DbCommand)
ExecuteNonQuery()

Esegue il comando corrente.Executes the current command.

ExecuteNonQueryAsync()

Versione asincrona di ExecuteNonQuery(), che esegue un'istruzione SQL a fronte di un oggetto di connessione.An asynchronous version of ExecuteNonQuery(), which executes a SQL statement against a connection object.

Richiama ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.Invokes ExecuteNonQueryAsync(CancellationToken) with CancellationToken.None.

(Ereditato da DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Si tratta della versione asincrona di ExecuteNonQuery().This is the asynchronous version of ExecuteNonQuery(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere ignorato.The cancellation token may optionally be ignored.

L'implementazione predefinita richiama il metodo sincrono ExecuteNonQuery() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous ExecuteNonQuery() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Le eccezioni generate da ExecuteNonQuery() verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by ExecuteNonQuery() will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Ereditato da DbCommand)
ExecuteReader()

Esegue il comando e restituisce un lettore di dati.Executes the command and returns a data reader.

ExecuteReader(CommandBehavior)

Compila CommandText in un albero dei comandi e la passa al provider sottostante dell'archivio per l'esecuzione, quindi compila EntityDataReader dal set di risultati prodotto utilizzando il CommandBehavior specificato.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()

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) con CancellationToken.None.Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) with CancellationToken.None.

(Ereditato da DbCommand)
ExecuteReaderAsync(CancellationToken)

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader. Questo metodo propaga la notifica di richiesta di annullamento delle operazioni.This method propagates a notification that operations should be canceled.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior)

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReaderAn asynchronous version of ExecuteReader, which executes the CommandText against the Connection and returns a DbDataReader.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).Invokes ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteScalar()

Esegue il comando e restituisce la prima colonna della prima riga nel gruppo di risultati.Executes the command, and returns the first column of the first row in the result set. Eventuali colonne o righe aggiuntive vengono ignorate.Additional columns or rows are ignored.

ExecuteScalarAsync()

Una versione asincrona di ExecuteScalar() che esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query.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. Tutte le altre righe e colonne vengono ignorate.All other columns and rows are ignored.

Richiama ExecuteScalarAsync(CancellationToken) con CancellationToken.None.Invokes ExecuteScalarAsync(CancellationToken) with CancellationToken.None.

(Ereditato da DbCommand)
ExecuteScalarAsync(CancellationToken)

Si tratta della versione asincrona di ExecuteScalar().This is the asynchronous version of ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata.Providers should override with an appropriate implementation. Il token di annullamento può facoltativamente essere ignorato.The cancellation token may optionally be ignored.

L'implementazione predefinita richiama il metodo sincrono ExecuteScalar() e restituisce un'attività completata, bloccando il thread chiamante.The default implementation invokes the synchronous ExecuteScalar() method and returns a completed task, blocking the calling thread. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Le eccezioni generate da ExecuteScalar verranno passate mediante la proprietà Task Exception restituita.Exceptions thrown by ExecuteScalar will be communicated via the returned Task Exception property.

Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.Do not invoke other methods and properties of the DbCommand object until the returned Task is complete.

(Ereditato da DbCommand)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
Prepare()

Compila il comando livello di entità e crea una versione preparata del comando.Compiles the entity-level command and creates a prepared version of the command.

PrepareAsync(CancellationToken)

Crea una versione preparata (o compilata) del comando nell'origine dati in modo asincrono.Asynchronously creates a prepared (or compiled) version of the command on the data source.

(Ereditato da DbCommand)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)
ToTraceString()

Compila il comando a livello di entità e restituisce il testo del comando di archiviazione.Compiles the entity-level command and returns the store command text.

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Implementazioni dell'interfaccia esplicita

IDbCommand.Connection

Ottiene o imposta l'oggetto IDbConnection usato da questa istanza dell'oggetto IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

(Ereditato da DbCommand)
IDbCommand.CreateParameter()

Crea una nuova istanza di un oggetto IDbDataParameter .Creates a new instance of an IDbDataParameter object.

(Ereditato da DbCommand)
IDbCommand.ExecuteReader()

Esegue la proprietà CommandText su Connection e compila IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

(Ereditato da DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)

Esegue la proprietà CommandText su Connection e compila IDataReader usando uno dei valori di CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

(Ereditato da DbCommand)
IDbCommand.Parameters

Ottiene l'oggetto IDataParameterCollection.Gets the IDataParameterCollection.

(Ereditato da DbCommand)
IDbCommand.Transaction

Ottiene o imposta la proprietà DbTransaction in cui viene eseguito questo oggetto DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

(Ereditato da DbCommand)

Si applica a