DbCommand Classe

Definizione

Spazio dei nomi:

System.Data.Common

Assembly:

System.Data.Common.dll

Origine:

DbCommand.cs

Rappresenta un'istruzione SQL o una stored procedure da eseguire su un'origine dati. Fornisce una classe base per classi specifiche del database che rappresentano i comandi. ExecuteNonQueryAsync.

public ref class DbCommand abstract : System::ComponentModel::Component, IAsyncDisposable, IDisposable, System::Data::IDbCommand

public abstract class DbCommand : System.ComponentModel.Component, IAsyncDisposable, IDisposable, System.Data.IDbCommand

type DbCommand = class
    inherit Component
    interface IDbCommand
    interface IDisposable
    interface IAsyncDisposable

Public MustInherit Class DbCommand
Inherits Component
Implements IAsyncDisposable, IDbCommand, IDisposable

Ereditarietà

Object

MarshalByRefObject

Component

DbCommand

Derivato

System.Data.EntityClient.EntityCommand

System.Data.Odbc.OdbcCommand

System.Data.OleDb.OleDbCommand

System.Data.SqlClient.SqlCommand

Implementazioni

IDisposable IDbCommand IAsyncDisposable

Costruttori

DbCommand()

Costruisce un'istanza dell'oggetto DbCommand.

Proprietà

CanRaiseEvents	Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component)
CommandText	Ottiene o imposta il comando di testo da eseguire sull'origine dati.
CommandTimeout	Ottiene o imposta il tempo di attesa , espresso in secondi, prima di terminare il tentativo di eseguire il comando e generare un errore.
CommandType	Ottiene o imposta la modalità di interpretazione della proprietà CommandText.
Connection	Ottiene o imposta il DbConnection utilizzato da questo DbCommand.
Container	Ottiene il IContainer che contiene il Component. (Ereditato da Component)
DbConnection	Ottiene o imposta il DbConnection utilizzato da questo DbCommand.
DbParameterCollection	Ottiene l'insieme di oggetti DbParameter.
DbTransaction	Ottiene o imposta la DbTransaction all'interno della quale viene eseguito l'oggetto DbCommand.
DesignMode	Ottiene un valore che indica se la Component è attualmente in modalità progettazione. (Ereditato da Component)
DesignTimeVisible	Ottiene o imposta un valore che indica se l'oggetto comando deve essere visibile in un controllo interfaccia personalizzato.
Events	Ottiene l'elenco dei gestori eventi associati a questo Component. (Ereditato da Component)
Parameters	Ottiene l'insieme di oggetti DbParameter. Per altre informazioni sui parametri, vedere Configurazione dei parametri e dei tipi di dati dei parametri.
Site	Ottiene o imposta il ISite del Component. (Ereditato da Component)
Transaction	Ottiene o imposta la DbTransaction all'interno della quale viene eseguito l'oggetto DbCommand.
UpdatedRowSource	Ottiene o imposta la modalità di applicazione dei risultati del comando al DataRow quando viene utilizzato dal metodo Update di un DbDataAdapter.

Metodi

Cancel()	Tenta di annullare l'esecuzione di un DbCommand.
CreateDbParameter()	Crea una nuova istanza di un oggetto DbParameter.
CreateObjRef(Type)	Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject)
CreateParameter()	Crea una nuova istanza di un oggetto DbParameter.
Dispose()	Rilascia tutte le risorse usate dal Component. (Ereditato da Component)
Dispose(Boolean)	Rilascia le risorse non gestite usate dal Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component)
DisposeAsync()	Depose in modo asincrono l'oggetto comando.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
ExecuteDbDataReader(CommandBehavior)	Esegue il comando sulla connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)	I provider devono implementare questo metodo per fornire un'implementazione non predefinita per gli overload ExecuteReader. L'implementazione predefinita richiama il metodo ExecuteReader() sincrono e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteReader verranno comunicate tramite la proprietà Task Exception restituita. Questo metodo accetta un token di annullamento che può essere usato per richiedere l'annullamento anticipato dell'operazione. Le implementazioni possono ignorare questa richiesta.
ExecuteNonQuery()	Esegue il comando sul relativo oggetto connessione, restituendo il numero di righe interessate.
ExecuteNonQueryAsync()	Versione asincrona di ExecuteNonQuery(), che esegue il comando sul relativo oggetto connessione, restituendo il numero di righe interessate. Richiama ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.
ExecuteNonQueryAsync(CancellationToken)	Si tratta della versione asincrona di ExecuteNonQuery(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato. L'implementazione predefinita richiama il metodo ExecuteNonQuery() sincrono e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteNonQuery() verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto DbCommand fino al completamento dell'attività restituita.
ExecuteReader()	Esegue il comando sulla connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteReader(CommandBehavior)	Esegue il comando sulla connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati.
ExecuteReaderAsync()	Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati. Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) con CancellationToken.None.
ExecuteReaderAsync(CancellationToken)	Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati. Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior)	Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader che può essere usato per accedere ai risultati. Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteReaderAsync(CommandBehavior, CancellationToken)	Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).
ExecuteScalar()	Esegue il comando e restituisce la prima colonna della prima riga del primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate.
ExecuteScalarAsync()	Versione asincrona di ExecuteScalar(), che esegue il comando e restituisce la prima colonna della prima riga nel primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati vengono ignorate. Richiama ExecuteScalarAsync(CancellationToken) con CancellationToken.None.
ExecuteScalarAsync(CancellationToken)	Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Facoltativamente, il token di annullamento può essere ignorato. L'implementazione predefinita richiama il metodo ExecuteScalar() sincrono e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se è stato passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno comunicate tramite la proprietà Task Exception restituita. Non richiamare altri metodi e proprietà dell'oggetto DbCommand fino al completamento dell'attività restituita.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetLifetimeService()	Obsoleti. Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
GetService(Type)	Restituisce un oggetto che rappresenta un servizio fornito dal Component o dal relativo Container. (Ereditato da Component)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
InitializeLifetimeService()	Obsoleti. Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
MemberwiseClone(Boolean)	Crea una copia superficiale dell'oggetto MarshalByRefObject corrente. (Ereditato da MarshalByRefObject)
Prepare()	Crea una versione preparata (o compilata) del comando nell'origine dati.
PrepareAsync(CancellationToken)	Crea in modo asincrono una versione preparata (o compilata) del comando nell'origine dati.
ToString()	Restituisce un String contenente il nome del Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component)

Eventi

Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component)

Implementazioni dell'interfaccia esplicita

IDbCommand.Connection	Ottiene o imposta la IDbConnection utilizzata da questa istanza del IDbCommand.
IDbCommand.CreateParameter()	Crea una nuova istanza di un oggetto IDbDataParameter.
IDbCommand.ExecuteReader()	Esegue il CommandText sul Connection e compila un IDataReader.
IDbCommand.ExecuteReader(CommandBehavior)	Esegue il CommandText sul Connectione compila un IDataReader usando uno dei valori di CommandBehavior.
IDbCommand.Parameters	Ottiene il IDataParameterCollection.
IDbCommand.Transaction	Ottiene o imposta la DbTransaction all'interno della quale viene eseguito l'oggetto DbCommand.

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono.

Vedi anche

• ADO.NET Panoramica