OleDbCommand Classe

Definizione

Rappresenta un'istruzione SQL o una stored procedure da eseguire su un'origine dati.

public ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable, IDisposable
public ref class OleDbCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
type OleDbCommand = class
    inherit Component
    interface ICloneable
    interface IDbCommand
    interface IDisposable
type OleDbCommand = class
    inherit DbCommand
    interface ICloneable
    interface IDbCommand
    interface IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Ereditarietà
OleDbCommand
Ereditarietà
Ereditarietà
Implementazioni

Esempio

Nell'esempio seguente vengono utilizzati OleDbCommand , insieme a e , per selezionare righe da un database di OleDbDataAdapter OleDbConnection Access. Viene quindi DataSet restituito l'oggetto compilato. Nell'esempio vengono passati un inizializzato, una stringa di connessione, una stringa di query che è un'istruzione SELECT SQL e una stringa che rappresenta il nome della tabella DataSet del database di origine.

public void ReadMyData(string connectionString)
{
    string queryString = "SELECT OrderID, CustomerID FROM Orders";
    using (OleDbConnection connection = new OleDbConnection(connectionString))
    {
        OleDbCommand command = new OleDbCommand(queryString, connection);
        connection.Open();
        OleDbDataReader reader = command.ExecuteReader();

        while (reader.Read())
        {
            Console.WriteLine(reader.GetInt32(0) + ", " + reader.GetString(1));
        }
        // always call Close when done reading.
        reader.Close();
    }
}
Public Sub ReadMyData(ByVal connectionString As String)
    Dim queryString As String = "SELECT OrderID, CustomerID FROM Orders"
    Using connection As New OleDbConnection(connectionString)
        Dim command As New OleDbCommand(queryString, connection)

        connection.Open()

        Dim reader As OleDbDataReader = command.ExecuteReader()
        While reader.Read()
            Console.WriteLine(reader.GetInt32(0).ToString() + ", " _
               + reader.GetString(1))
        End While

        ' always call Close when done reading.
        reader.Close()
    End Using
End Sub

Commenti

Quando viene creata OleDbCommand un'istanza di , le proprietà di lettura/scrittura vengono impostate sui valori iniziali. Per un elenco di questi valori, vedere il OleDbCommand costruttore .

OleDbCommand include i metodi seguenti che eseguono comandi in un'origine dati:

Elemento Descrizione
ExecuteReader Esegue comandi che restituiscono righe. ExecuteReaderpotrebbe non avere l'effetto desiderato se usato per eseguire comandi come SQL istruzioni SET.
ExecuteNonQuery Esegue comandi come SQL istruzioni INSERT, DELETE, UPDATE e SET.
ExecuteScalar Recupera un singolo valore, ad esempio un valore aggregato da un database.

È possibile reimpostare la CommandText proprietà e riutilizzare l'oggetto OleDbCommand . Tuttavia, è necessario chiudere OleDbDataReader prima di poter eseguire un comando nuovo o precedente.

Se un errore irreversibile (ad esempio, un livello di gravità SQL Server 20 o superiore) viene generato dal metodo che esegue un , la connessione potrebbe OleDbException OleDbCommand essere OleDbConnection chiusa. L'utente può tuttavia riaprire la connessione e continuare.

Costruttori

OleDbCommand()

Inizializza una nuova istanza della classe OleDbCommand.

OleDbCommand(String)

Inizializza una nuova istanza della classe OleDbCommand con il testo della query.

OleDbCommand(String, OleDbConnection)

Inizializza una nuova istanza della classe OleDbCommand con il testo della query e un oggetto OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inizializza una nuova istanza della classe OleDbCommand con il testo della query, un oggetto OleDbConnection e la proprietà Transaction.

Proprietà

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.

(Ereditato da Component)
CommandText

Ottiene o imposta l'istruzione SQL o la stored procedure da eseguire all'origine dati.

CommandTimeout

Ottiene o imposta il tempo di attesa (in secondi) prima di terminare un tentativo di eseguire un comando e generare un errore.

CommandType

Ottiene o imposta un valore che indica come viene interpretata la proprietà CommandText.

Connection

Ottiene o imposta l'oggetto OleDbConnection usato da questa istanza dell'oggetto OleDbCommand.

Container

Ottiene l'oggetto IContainer che contiene Component.

(Ereditato da Component)
DbConnection

In caso di override in una classe derivata, ottiene o imposta la DbConnection usata da questo DbCommand.

(Ereditato da DbCommand)
DbParameterCollection

In caso di override in una classe derivata, ottiene la raccolta di oggetti DbParameter.

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

(Ereditato da DbCommand)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.

(Ereditato da Component)
DesignTimeVisible

Ottiene o imposta un valore che indica se l'oggetto comando deve essere visualizzato in un controllo Progettazione Windows Form personalizzato.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.

(Ereditato da Component)
Parameters

Ottiene l'oggetto OleDbParameterCollection.

Site

Ottiene o imposta l'oggetto ISite di Component.

(Ereditato da Component)
Transaction

Ottiene o imposta l'oggetto OleDbTransaction in cui viene eseguito OleDbCommand.

UpdatedRowSource

Ottiene o imposta le modalità di applicazione dei risultati del comando all'oggetto DataRow quando utilizzato dal metodo Update dell'oggetto OleDbDataAdapter.

Metodi

Cancel()

Tenta di annullare l'esecuzione di una classe OleDbCommand.

Clone()

Crea un nuovo oggetto OleDbCommand che è una copia dell'istanza corrente.

CreateDbParameter()

In caso di override in una classe derivata, crea una nuova istanza di un oggetto DbParameter.

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

(Ereditato da MarshalByRefObject)
CreateParameter()

Crea una nuova istanza di un oggetto OleDbParameter .

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

(Ereditato da DbCommand)
Dispose()

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da DbCommand e, facoltativamente, le risorse gestite.

(Ereditato da DbCommand)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.

(Ereditato da Component)
DisposeAsync()

Elimina in modo asincrono l'oggetto comando.

(Ereditato da DbCommand)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
ExecuteDbDataReader(CommandBehavior)

In caso di override in una classe derivata, esegue il testo del comando sulla connessione.

(Ereditato da DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

I provider devono implementare questo metodo per fornire un'implementazione non predefinita per gli overload di ExecuteReader .

L'implementazione predefinita richiama il metodo sincrono ExecuteReader() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteReader verranno passate mediante la proprietà Task Exception restituita.

Questo metodo accetta un token di annullamento che può essere utilizzato per richiedere che l'operazione venga annullata in anticipo. Le implementazioni possono ignorare la richiesta.

(Ereditato da DbCommand)
ExecuteNonQuery()

Esegue un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.

ExecuteNonQueryAsync()

Versione asincrona di ExecuteNonQuery(), che esegue un'istruzione SQL a fronte di un oggetto di connessione.

Richiama ExecuteNonQueryAsync(CancellationToken) con CancellationToken.None.

(Ereditato da DbCommand)
ExecuteNonQueryAsync(CancellationToken)

Si tratta della versione asincrona di ExecuteNonQuery(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può facoltativamente essere ignorato.

L'implementazione predefinita richiama il metodo sincrono ExecuteNonQuery() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteNonQuery() verranno passate mediante la proprietà Task Exception restituita.

Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.

(Ereditato da DbCommand)
ExecuteReader()

Invia CommandText a Connection e compila un oggetto OleDbDataReader.

ExecuteReader(CommandBehavior)

Invia la proprietà CommandText alla proprietà Connection e compila una classe OleDbDataReader mediante uno dei valori di CommandBehavior.

ExecuteReaderAsync()

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReader

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

(Ereditato da DbCommand)
ExecuteReaderAsync(CancellationToken)

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReader Questo metodo propaga la notifica di richiesta di annullamento delle operazioni.

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior)

Versione asincrona di ExecuteReader, che esegue CommandText in un Connection e restituisce un DbDataReader

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

Richiama ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken).

(Ereditato da DbCommand)
ExecuteScalar()

Esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query. Eventuali colonne o righe aggiuntive vengono ignorate.

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. Tutte le altre righe e colonne vengono ignorate.

Richiama ExecuteScalarAsync(CancellationToken) con CancellationToken.None.

(Ereditato da DbCommand)
ExecuteScalarAsync(CancellationToken)

Si tratta della versione asincrona di ExecuteScalar(). I provider devono eseguire l'override con un'implementazione appropriata. Il token di annullamento può facoltativamente essere ignorato.

L'implementazione predefinita richiama il metodo sincrono ExecuteScalar() e restituisce un'attività completata, bloccando il thread chiamante. L'implementazione predefinita restituirà un'attività annullata se viene passato un token di annullamento già annullato. Le eccezioni generate da ExecuteScalar verranno passate mediante la proprietà Task Exception restituita.

Non richiamare altri metodi e proprietà dell'oggetto DbCommand finché l'attività restituita non viene completata.

(Ereditato da DbCommand)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetLifetimeService()
Obsoleta.

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
InitializeLifetimeService()
Obsoleta.

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.

(Ereditato da MarshalByRefObject)
Prepare()

Crea una versione preparata o compilata del comando nell'origine dati.

PrepareAsync(CancellationToken)

Crea una versione preparata (o compilata) del comando nell'origine dati in modo asincrono.

(Ereditato da DbCommand)
ResetCommandTimeout()

Reimposta la proprietà CommandTimeout sul valore predefinito.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)
ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. 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

ICloneable.Clone()

Per una descrizione di questo membro, vedere Clone().

IDbCommand.Connection

Ottiene o imposta l'oggetto IDbConnection usato da questa istanza dell'oggetto IDbCommand.

(Ereditato da DbCommand)
IDbCommand.CreateParameter()

Questa API supporta l'infrastruttura del prodotto e non è previsto che venga usata direttamente dal codice.

Crea una nuova istanza di un oggetto IDbDataParameter .

IDbCommand.CreateParameter()

Crea una nuova istanza di un oggetto IDbDataParameter .

(Ereditato da DbCommand)
IDbCommand.ExecuteReader()

Per una descrizione di questo membro, vedere ExecuteReader().

IDbCommand.ExecuteReader(CommandBehavior)

Esegue la proprietà CommandText su Connection e compila IDataReader usando uno dei valori di CommandBehavior.

IDbCommand.Parameters

Ottiene l'oggetto IDataParameterCollection.

(Ereditato da DbCommand)
IDbCommand.Transaction

Ottiene o imposta la proprietà DbTransaction in cui viene eseguito questo oggetto DbCommand.

(Ereditato da DbCommand)

Si applica a

Vedi anche