OleDbCommand Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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
type OleDbCommand = class
inherit DbCommand
interface ICloneable
interface IDbCommand
interface IDisposable
type OleDbCommand = class
inherit Component
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à
- Ereditarietà
- Implementazioni
Esempio
Nell'esempio seguente viene usato il OleDbCommand, lungo OleDbDataAdapter e OleDbConnection, per selezionare le righe da un database di Access. Viene quindi restituito il DataSet riempito. Nell'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.
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 valori iniziali. Per un elenco di questi valori, vedere il costruttore OleDbCommand.
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 proprietà CommandText e riutilizzare l'oggetto OleDbCommand. Tuttavia, è necessario chiudere il OleDbDataReader prima di poter eseguire un comando nuovo o precedente.
Se un OleDbException irreversibile (ad esempio, un livello di gravità di SQL Server pari o superiore a 20) viene generato dal metodo che esegue un OleDbCommand, l'OleDbConnection, la connessione potrebbe essere chiusa. Tuttavia, l'utente può 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 OleDbConnection. |
OleDbCommand(String, OleDbConnection, OleDbTransaction) |
Inizializza una nuova istanza della classe OleDbCommand con il testo della query, un OleDbConnectione l'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 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 proprietà CommandText. |
Connection |
Ottiene o imposta la OleDbConnection utilizzata da questa istanza del OleDbCommand. |
Container |
Ottiene il IContainer che contiene il Component. (Ereditato da Component) |
DbConnection |
Ottiene o imposta il DbConnection utilizzato da questo DbCommand. (Ereditato da DbCommand) |
DbParameterCollection |
Ottiene l'insieme di oggetti DbParameter. (Ereditato da DbCommand) |
DbTransaction |
Ottiene o imposta la DbTransaction all'interno della quale viene eseguito l'oggetto DbCommand. (Ereditato da 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 di Progettazione Windows Form personalizzato. |
Events |
Ottiene l'elenco dei gestori eventi associati a questo Component. (Ereditato da Component) |
Parameters |
Ottiene il OleDbParameterCollection. |
Site |
Ottiene o imposta il ISite del Component. (Ereditato da Component) |
Transaction |
Ottiene o imposta il OleDbTransaction all'interno del quale viene eseguito il OleDbCommand. |
UpdatedRowSource |
Ottiene o imposta la modalità di applicazione dei risultati del comando al DataRow quando viene utilizzato dal metodo |
Metodi
Cancel() |
Tenta di annullare l'esecuzione di un OleDbCommand. |
Clone() |
Crea un nuovo oggetto OleDbCommand che rappresenta una copia dell'istanza corrente. |
CreateDbParameter() |
Crea una nuova istanza di un oggetto DbParameter. (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 oggetto OleDbParameter. |
Dispose() |
Esegue attività definite dall'applicazione associate alla liberazione, al rilascio o alla reimpostazione di risorse non gestite. (Ereditato da DbCommand) |
Dispose() |
Rilascia tutte le risorse usate dal Component. (Ereditato da Component) |
Dispose(Boolean) |
Rilascia le risorse non gestite usate dal DbCommand e, facoltativamente, rilascia le risorse gestite. (Ereditato da DbCommand) |
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. (Ereditato da DbCommand) |
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. (Ereditato da DbCommand) |
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. (Ereditato da DbCommand) |
ExecuteNonQuery() |
Esegue un'istruzione SQL sulla 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. 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. 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 |
ExecuteReader() |
Invia il CommandText al Connection e compila un OleDbDataReader. |
ExecuteReader(CommandBehavior) |
Invia il CommandText all'Connectione compila un OleDbDataReader usando uno dei valori di CommandBehavior. |
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. (Ereditato da DbCommand) |
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). (Ereditato da DbCommand) |
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). (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. 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 nel primo set di risultati restituito. Tutte le altre colonne, righe e set di risultati 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. 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 |
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. (Ereditato da DbCommand) |
ResetCommandTimeout() |
Reimposta la proprietà CommandTimeout sul valore predefinito. |
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
ICloneable.Clone() |
Per una descrizione di questo membro, vedere Clone(). |
IDbCommand.Connection |
Ottiene o imposta la IDbConnection utilizzata da questa istanza del 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 il CommandText sul Connectione compila un IDataReader usando uno dei valori di CommandBehavior. |
IDbCommand.Parameters |
Ottiene il IDataParameterCollection. (Ereditato da DbCommand) |
IDbCommand.Transaction |
Ottiene o imposta la DbTransaction all'interno della quale viene eseguito l'oggetto DbCommand. (Ereditato da DbCommand) |
Metodi di estensione
ConfigureAwait(IAsyncDisposable, Boolean) |
Configura il modo in cui verranno eseguite le attese nelle attività restituite da un oggetto eliminabile asincrono. |