OleDbCommand Classe

Definizione

Rappresenta un'istruzione SQL o una stored procedure da eseguire su un'origine dati.Represents an SQL statement or stored procedure to execute against a data source.

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

Esempio

Nell'esempio seguente vengono utilizzate le OleDbCommand, insieme OleDbDataAdapter e OleDbConnection, per selezionare le righe da un database di Access.The following example uses the OleDbCommand, along OleDbDataAdapter and OleDbConnection, to select rows from an Access database. Viene quindi restituita la DataSet compilata.The filled DataSet is then returned. All'esempio viene passato un DataSetinizializzato, una stringa di connessione, una stringa di query che è un'istruzione SQL SELECT e una stringa che rappresenta il nome della tabella del database di origine.The example is passed an initialized DataSet, a connection string, a query string that is an SQL SELECT statement, and a string that is the name of the source database table.

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 un'istanza di OleDbCommand, le proprietà di lettura/scrittura vengono impostate sui rispettivi valori iniziali.When an instance of OleDbCommand is created, the read/write properties are set to their initial values. Per un elenco di questi valori, vedere il costruttore OleDbCommand.For a list of these values, see the OleDbCommand constructor.

OleDbCommand include i metodi seguenti per l'esecuzione di comandi in un'origine dati:OleDbCommand features the following methods executing commands at a data source:

ElementoItem DescrizioneDescription
ExecuteReader Esegue i comandi che restituiscono righe.Executes commands that return rows. ExecuteReader potrebbe non avere l'effetto desiderato se utilizzato per eseguire comandi, ad esempio istruzioni SQL SET.ExecuteReader may not have the effect that you want if used to execute commands such as SQL SET statements.
ExecuteNonQuery Esegue comandi come istruzioni SQL INSERT, DELETE, UPDATE e SET.Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.
ExecuteScalar Recupera un singolo valore, ad esempio, un valore di aggregazione da un database.Retrieves a single value, for example, an aggregate value from a database.

È possibile reimpostare la proprietà CommandText e riutilizzare l'oggetto OleDbCommand.You can reset the CommandText property and reuse the OleDbCommand object. Tuttavia, è necessario chiudere il OleDbDataReader prima di poter eseguire un comando nuovo o precedente.However, you must close the OleDbDataReader before you can execute a new or previous command.

Se un OleDbException irreversibile (ad esempio, un livello di gravità SQL Server maggiore o uguale a 20) viene generato dal metodo che esegue un OleDbCommand, il OleDbConnection, la connessione può essere chiusa.If a fatal OleDbException (for example, a SQL Server severity level of 20 or greater) is generated by the method executing an OleDbCommand, the OleDbConnection, the connection may be closed. L'utente può tuttavia riaprire la connessione e continuare.However, the user can reopen the connection and continue.

Costruttori

OleDbCommand()

Inizializza una nuova istanza della classe OleDbCommand.Initializes a new instance of the OleDbCommand class.

OleDbCommand(String)

Inizializza una nuova istanza della classe OleDbCommand con il testo della query.Initializes a new instance of the OleDbCommand class with the text of the query.

OleDbCommand(String, OleDbConnection)

Inizializza una nuova istanza della classe OleDbCommand con il testo della query e un oggetto OleDbConnection.Initializes a new instance of the OleDbCommand class with the text of the query and an OleDbConnection.

OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inizializza una nuova istanza della classe OleDbCommand con il testo della query, un oggetto OleDbConnection e la proprietà Transaction.Initializes a new instance of the OleDbCommand class with the text of the query, an OleDbConnection, and the 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 l'istruzione SQL o la stored procedure da eseguire all'origine dati.Gets or sets the SQL statement or stored procedure to execute at the data source.

CommandTimeout

Ottiene o imposta il tempo di attesa (in secondi) prima di terminare un tentativo di eseguire un comando e generare un errore.Gets or sets the wait time (in seconds) before terminating an attempt to execute a command and generating an error.

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

Connection

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

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.

(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 visualizzato in un controllo Progettazione Windows Form personalizzato.Gets or sets a value that indicates whether the command object should be visible in a customized Windows Forms Designer 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 l'oggetto OleDbParameterCollection.Gets the OleDbParameterCollection.

Site

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

(Ereditato da Component)
Transaction

Ottiene o imposta l'oggetto OleDbTransaction in cui viene eseguito OleDbCommand.Gets or sets the OleDbTransaction within which the OleDbCommand executes.

UpdatedRowSource

Ottiene o imposta le modalità di applicazione dei risultati del comando all'oggetto DataRow quando utilizzato dal metodo Update dell'oggetto OleDbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update method of the OleDbDataAdapter.

Metodi

Cancel()

Tenta di annullare l'esecuzione di una classe OleDbCommand.Tries to cancel the execution of an OleDbCommand.

Clone()

Crea un nuovo oggetto OleDbCommand che è una copia dell'istanza corrente.Creates a new OleDbCommand object that is a copy of the current instance.

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

Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

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

(Ereditato da Component)
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 un'istruzione SQL nella proprietà Connection e restituisce il numero di righe modificate.Executes an SQL statement against the Connection and returns the number of rows affected.

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

Invia CommandText a Connection e compila un oggetto OleDbDataReader.Sends the CommandText to the Connection and builds an OleDbDataReader.

ExecuteReader(CommandBehavior)

Invia la proprietà CommandText alla proprietà Connection e compila una classe OleDbDataReader mediante uno dei valori di CommandBehavior.Sends the CommandText to the Connection, and builds an OleDbDataReader 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.

(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 la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query.Executes the query, and returns the first column of the first row in the result set returned by the query. 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()

Crea una versione preparata o compilata del comando nell'origine dati.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.

(Ereditato da DbCommand)
ResetCommandTimeout()

Reimposta la proprietà CommandTimeout sul valore predefinito.Resets the CommandTimeout property to the default value.

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

ICloneable.Clone()

Per una descrizione di questo membro, vedere Clone().For a description of this member, see Clone().

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.

IDbCommand.ExecuteReader()

Per una descrizione di questo membro, vedere ExecuteReader().For a description of this member, see ExecuteReader().

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.

(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

Vedi anche