Condividi tramite

OleDbCommand Classe

Definizione

Spazio dei nomi:
System.Data.OleDb
Assembly:
System.Data.OleDb.dll
Assembly:
System.Data.dll
Pacchetto:
System.Data.OleDb v11.0.0-preview.2.26159.112
Origine:
OleDbCommand.cs
Origine:
OleDbCommand.cs
Origine:
OleDbCommand.cs
Origine:
OleDbCommand.cs

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 ref class OleDbCommand sealed : System::Data::Common::DbCommand, ICloneable
[System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")]
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable, IDisposable
public sealed class OleDbCommand : System.Data.Common.DbCommand, ICloneable
[<System.Diagnostics.CodeAnalysis.RequiresDynamicCode("OleDbConnection is not AOT-compatible.")>]
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
type OleDbCommand = class
    inherit DbCommand
    interface IDbCommand
    interface IDisposable
    interface ICloneable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable, IDisposable
Public NotInheritable Class OleDbCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
Public NotInheritable Class OleDbCommand
Inherits DbCommand
Implements ICloneable
Ereditarietà
Object
DbCommand
OleDbCommand
Ereditarietà
Object
MarshalByRefObject
Component
DbCommand
OleDbCommand
Ereditarietà
Object
MarshalByRefObject
Component
OleDbCommand
Attributi
RequiresDynamicCodeAttribute
Implementazioni
IDbCommand ICloneable IDisposable

Esempio

Nell'esempio seguente vengono usati , OleDbCommandinsieme OleDbDataAdapter a e OleDbConnectionper selezionare le righe da un database di Access. Viene quindi restituito il riempimento DataSet . Nell'esempio viene passato un oggetto inizializzato DataSet, una stringa di connessione, una stringa di query che è un'istruzione SQL SELECT e una stringa che rappresenta il nome della tabella di 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 un'istanza di , le proprietà di OleDbCommand 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:

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

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

Se un valore irreversibile OleDbException ( ad esempio, un livello di gravità di SQL Server pari o superiore a 20) viene generato dal metodo che esegue un OleDbCommandoggetto , la OleDbConnectionconnessione potrebbe essere chiusa. Tuttavia, l'utente può riaprire la connessione e continuare.

Costruttori

Nome Descrizione
OleDbCommand()

Inizializza una nuova istanza della classe OleDbCommand.
OleDbCommand(String, OleDbConnection, OleDbTransaction)

Inizializza una nuova istanza della OleDbCommand classe con il testo della query, un OleDbConnectionoggetto e .Transaction
OleDbCommand(String, OleDbConnection)

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

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

Proprietà

Nome Descrizione
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 nell'origine dati.
CommandTimeout

Ottiene o imposta il tempo di attesa , espresso 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 CommandText proprietà.
Connection

Ottiene o imposta l'oggetto OleDbConnection utilizzato da questa istanza di OleDbCommand.
Container

Ottiene l'oggetto IContainer contenente l'oggetto Component.

(Ereditato da Component)
DbConnection

Ottiene o imposta l'oggetto DbConnection utilizzato da questo DbCommandoggetto .

(Ereditato da DbCommand)
DbParameterCollection

Ottiene la raccolta di DbParameter oggetti .

(Ereditato da DbCommand)
DbTransaction

Ottiene o imposta l'oggetto all'interno del quale viene eseguito l'oggetto DbTransactionDbCommand .

(Ereditato da DbCommand)
DesignMode

Ottiene un valore che indica se è 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 di Progettazione Windows Form personalizzato.
Events

Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto .

(Ereditato da Component)
Parameters

Ottiene l'oggetto OleDbParameterCollection.
Site

Ottiene o imposta l'oggetto ISite dell'oggetto Component.

(Ereditato da Component)
Transaction

Ottiene o imposta l'oggetto all'interno del OleDbTransaction quale viene eseguito l'oggetto OleDbCommand .
UpdatedRowSource

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

Metodi

Nome Descrizione
Cancel()

Tenta di annullare l'esecuzione di un oggetto OleDbCommand.
Clone()

Crea un nuovo OleDbCommand oggetto che rappresenta una copia dell'istanza corrente.
CreateDbParameter()

Crea una nuova istanza di un DbParameter oggetto .

(Ereditato da DbCommand)
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 OleDbParameter oggetto .
Dispose()

Rilascia tutte le risorse usate da Component.

(Ereditato da Component)
Dispose(Boolean)

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

(Ereditato da Component)
Equals(Object)

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

(Ereditato da Object)
ExecuteDbDataReader(CommandBehavior)

Esegue il comando sulla connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati.

(Ereditato da DbCommand)
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)

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

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

(Ereditato da DbCommand)
ExecuteNonQuery()

Esegue un'istruzione SQL su Connection e restituisce il numero di righe interessate.
ExecuteNonQueryAsync()

Versione asincrona di ExecuteNonQuery(), che esegue il comando sul relativo oggetto connessione, restituendo il numero di righe interessate.

ExecuteNonQueryAsync(CancellationToken) Richiama 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. Facoltativamente, il token di annullamento può 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 è 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.

(Ereditato da DbCommand)
ExecuteReader()

Invia all'oggetto CommandTextConnection e compila un oggetto OleDbDataReader.
ExecuteReader(CommandBehavior)

Invia l'oggetto ConnectionCommandText a e compila un oggetto OleDbDataReader usando uno dei CommandBehavior valori .
ExecuteReaderAsync()

Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati.

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

(Ereditato da DbCommand)
ExecuteReaderAsync(CancellationToken)

Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Richiama .

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior, CancellationToken)

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Richiama .

(Ereditato da DbCommand)
ExecuteReaderAsync(CommandBehavior)

Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto che può essere usato per accedere ai risultati.

ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken)Richiama .

(Ereditato da DbCommand)
ExecuteScalar()

Esegue la query e restituisce la prima colonna della prima riga nel set di risultati restituito dalla query. Le colonne o le righe aggiuntive vengono ignorate.
ExecuteScalarAsync()

Versione asincrona di ExecuteScalar(), che 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(CancellationToken) Richiama 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. Facoltativamente, il token di annullamento può 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 è 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.

(Ereditato da DbCommand)
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 da Component o da 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 corrente MarshalByRefObject .

(Ereditato da MarshalByRefObject)
Prepare()

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

Reimposta la CommandTimeout proprietà sul valore predefinito.
ToString()

Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override.

(Ereditato da Component)

Eventi

Nome Descrizione
Disposed

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

(Ereditato da Component)

Implementazioni dell'interfaccia esplicita

Nome Descrizione
ICloneable.Clone()

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

Ottiene o imposta l'oggetto IDbConnection utilizzato da questa istanza di 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 IDbDataParameter oggetto .
IDbCommand.CreateParameter()

Crea una nuova istanza di un IDbDataParameter oggetto .

(Ereditato da DbCommand)
IDbCommand.ExecuteReader()

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

Esegue l'oggetto CommandTextConnectionsu e compila un IDataReader oggetto usando uno dei CommandBehavior valori .
IDbCommand.Parameters

Ottiene l'oggetto IDataParameterCollection.

(Ereditato da DbCommand)
IDbCommand.Transaction

Ottiene o imposta l'oggetto all'interno del quale viene eseguito l'oggetto DbTransactionDbCommand .

(Ereditato da DbCommand)

Si applica a

Vedi anche