OleDbCommand OleDbCommand OleDbCommand OleDbCommand Class

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.

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à
Implementazioni

Esempi

L'esempio seguente usa il OleDbCommand, assieme OleDbDataAdapter e OleDbConnection, 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. Compilato DataSet viene quindi restituito.The filled DataSet is then returned. Nell'esempio viene passato un oggetto inizializzato DataSet, una stringa di connessione, una stringa di query che rappresenta un'istruzione SQL SELECT e una stringa che rappresenta il nome della tabella di 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 un'istanza di OleDbCommand viene creata, la lettura/scrittura proprietà vengono impostate sui 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 OleDbCommand costruttore.For a list of these values, see the OleDbCommand constructor.

OleDbCommand comprende i seguenti metodi 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 usata per eseguire comandi, ad esempio le istruzioni SET SQL.ExecuteReader may not have the effect that you want if used to execute commands such as SQL SET statements.
ExecuteNonQuery Esegue i comandi, ad esempio le 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 aggregato da un database.Retrieves a single value, for example, an aggregate value from a database.

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

Se un errore irreversibile OleDbException (ad esempio, un SQL Server livello gravità pari a 20 o superiore) viene generato dal metodo che esegue un OleDbCommand, il OleDbConnection, la connessione potrebbe venire 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() OleDbCommand() OleDbCommand() OleDbCommand()

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

OleDbCommand(String) OleDbCommand(String) OleDbCommand(String) 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) OleDbCommand(String, OleDbConnection) OleDbCommand(String, OleDbConnection) 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) OleDbCommand(String, OleDbConnection, OleDbTransaction) OleDbCommand(String, OleDbConnection, OleDbTransaction) 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 CanRaiseEvents CanRaiseEvents CanRaiseEvents

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

(Inherited from Component)
CommandText CommandText CommandText 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 CommandTimeout CommandTimeout CommandTimeout

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

CommandType CommandType CommandType 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 Connection Connection 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 Container Container Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode 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.

(Inherited from Component)
DesignTimeVisible DesignTimeVisible DesignTimeVisible 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 Events Events Events

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

(Inherited from Component)
Parameters Parameters Parameters Parameters

Ottiene l'oggetto OleDbParameterCollection.Gets the OleDbParameterCollection.

Site Site Site Site

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

(Inherited from Component)
Transaction Transaction Transaction Transaction

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

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

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

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

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
CreateParameter() CreateParameter() CreateParameter() CreateParameter()

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

Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

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

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() 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.

ExecuteReader() ExecuteReader() ExecuteReader() ExecuteReader()

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

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) 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.

ExecuteScalar() ExecuteScalar() ExecuteScalar() 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. Le colonne o le righe aggiuntive vengono ignorate.Additional columns or rows are ignored.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
Prepare() Prepare() Prepare() 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.

ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout() ResetCommandTimeout()

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

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

(Inherited from Component)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

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

IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter() IDbCommand.CreateParameter()
IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader() IDbCommand.ExecuteReader()

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

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) 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.

Eventi

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

(Inherited from Component)

Si applica a

Vedi anche