DbCommand Classe

Definizione

Rappresenta un'istruzione SQL o una stored procedure da eseguire in relazione a un'origine dati.Represents an SQL statement or stored procedure to execute against a data source. Fornisce una classe base per le classi specifiche del database che rappresentano i comandi.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
Ereditarietà
Derivato
Implementazioni

Costruttori

DbCommand()

Crea un'istanza dell'oggetto DbCommand.Constructs an instance of the DbCommand object.

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

In caso di override in una classe derivata, ottiene o imposta il comando di testo da eseguire sull'origine dati.When overridden in a derived class, gets or sets the text command to run against the data source.

CommandTimeout

In caso di override in una classe derivata, ottiene o imposta il tempo di attesa (in secondi) prima di terminare il tentativo di esecuzione di un comando e di generare un errore.When overridden in a derived class, gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

In caso di override in una classe derivata, ottiene o imposta il modo in cui viene interpretata la proprietà CommandText.When overridden in a derived class, gets or sets how the CommandText property is interpreted.

Connection

Ottiene o imposta la classe DbConnection utilizzata da questa classe DbCommand.Gets or sets the DbConnection used by this DbCommand.

Container

Ottiene il IContainer che contiene il 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.

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.

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.

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

In caso di override in una classe derivata, ottiene o imposta un valore che indica se l'oggetto comando deve essere visibile in un controllo di interfaccia personalizzato.When overridden in a derived class, gets or sets a value indicating whether the command object should be visible in a customized interface control.

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 la raccolta di oggetti DbParameter.Gets the collection of DbParameter objects. Per altre informazioni sui parametri, vedere Configurazione dei parametri e tipi di dati dei parametri.For more information on parameters, see Configuring Parameters and Parameter Data Types.

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 proprietà DbTransaction in cui viene eseguito questo oggetto DbCommand.Gets or sets the DbTransaction within which this DbCommand object executes.

UpdatedRowSource

In caso di override in una classe derivata, ottiene o imposta il modo in cui i risultati del comando vengono applicati a DataRow quando sono usati dal metodo Update di un DbDataAdapter.When overridden in a derived class, gets or sets how command results are applied to the DataRow when used by the Update method of a DbDataAdapter.

Metodi

Cancel()

In caso di override in una classe derivata, tenta di annullare l'esecuzione di un DbCommand.When overridden in a derived class, attempts to cancel the execution of a DbCommand.

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.

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 DbParameter.Creates a new instance of a DbParameter object.

Dispose()
Dispose(Boolean)
DisposeAsync()

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

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.

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.

ExecuteNonQuery()

In caso di override in una classe derivata, esegue un'istruzione SQL su un oggetto connessione.When overridden in a derived class, executes a SQL statement against a connection object.

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.

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.

ExecuteReader()

Esegue la proprietà CommandText sulla proprietà Connection e restituisce un oggetto DbDataReader.Executes the CommandText against the Connection, and returns an DbDataReader.

ExecuteReader(CommandBehavior)

Esegue la proprietà CommandText sulla proprietà Connection e restituisce un oggetto DbDataReader utilizzando uno dei valori di CommandBehavior.Executes the CommandText against the Connection, and returns an DbDataReader using one of the CommandBehavior values.

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.

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).

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).

ExecuteReaderAsync(CommandBehavior, CancellationToken)

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

ExecuteScalar()

In caso di override in una classe derivata, esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query.When overridden in a derived class, 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.

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.

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.

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

In caso di override in una classe derivata, crea una versione preparata (o compilata) del comando nell'origine dati.When overridden in a derived class, creates a prepared (or compiled) version of the command on the data source.

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.

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)

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.

IDbCommand.CreateParameter()

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

IDbCommand.ExecuteReader()

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

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.

IDbCommand.Parameters

Ottiene l'oggetto IDataParameterCollection.Gets the IDataParameterCollection.

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.

Si applica a

Vedi anche