OdbcCommand Classe

Definizione

Spazio dei nomi:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacchetto:

System.Data.Odbc v9.0.0-preview.3.24172.9

Origine:

OdbcCommand.cs

Rappresenta un'istruzione SQL o una stored procedure da eseguire su un'origine dati. La classe non può essere ereditata.

public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable

public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable

type OdbcCommand = class
    inherit DbCommand
    interface ICloneable

Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable

Ereditarietà

Object

MarshalByRefObject

Component

DbCommand

OdbcCommand

Implementazioni

ICloneable

Esempio

Nell'esempio seguente viene utilizzato ExecuteNonQuery:

public void InsertRow(string connectionString, string insertSQL)
{
    using (OdbcConnection connection =
               new OdbcConnection(connectionString))
    {
        // The insertSQL string contains a SQL statement that
        // inserts a new row in the source table.
        OdbcCommand command = new OdbcCommand(insertSQL, connection);

        // Open the connection and execute the insert command.
        try
        {
            connection.Open();
            command.ExecuteNonQuery();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
        // The connection is automatically closed when the
        // code exits the using block.
    }

Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OdbcConnection(connectionString)
        ' The insertSQL string contains a SQL statement that
        ' inserts a new row in the source table.
        Dim command As New OdbcCommand(insertSQL, connection)

        ' Open the connection and execute the insert command.
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try
        ' The connection is automatically closed when the
        ' code exits the Using block.
    End Using
End Sub

Commenti

La OdbcCommand classe fornisce i metodi seguenti per l'esecuzione di comandi su un'origine dati:

Elemento	Descrizione
ExecuteReader	Esegue i comandi che restituiscono righe.
ExecuteNonQuery	Esegue comandi come ISTRUZIONI SQL 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 OdbcCommand . Tuttavia, è necessario chiudere prima OdbcDataReader di poter eseguire un comando nuovo o precedente.

Se l'esecuzione del comando causa un errore irreversibileOdbcException, ad esempio un SQL Server livello di gravità pari a 20 o più, OdbcConnection può essere chiuso. L'utente può tuttavia riaprire la connessione e continuare.

Costruttori

OdbcCommand()	Inizializza una nuova istanza della classe OdbcCommand.
OdbcCommand(String)	Inizializza una nuova istanza della classe OdbcCommand con il testo della query.
OdbcCommand(String, OdbcConnection)	Inizializza una nuova istanza della classe OdbcCommand con il testo della query e un oggetto OdbcConnection.
OdbcCommand(String, OdbcConnection, OdbcTransaction)	Inizializza una nuova istanza della classe OdbcCommand con il testo della query, un oggetto OdbcConnection e l'oggetto 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 una stored procedure da eseguire sull'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 OdbcConnection usato da questa istanza dell'oggetto OdbcCommand.
Container	Ottiene l'oggetto IContainer che contiene Component. (Ereditato da Component)
DbConnection	Ottiene o imposta l'oggetto DbConnection utilizzato da DbCommand. (Ereditato da DbCommand)
DbParameterCollection	Ottiene la raccolta di oggetti DbParameter. (Ereditato da DbCommand)
DbTransaction	Ottiene o imposta la proprietà DbTransaction in cui 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 visibile in un controllo di interfaccia personalizzato.
Events	Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component)
Parameters	Ottiene l'oggetto OdbcParameterCollection.
Site	Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component)
Transaction	Ottiene o imposta l'oggetto OdbcTransaction in cui viene eseguito OdbcCommand.
UpdatedRowSource	Ottiene o imposta un valore che specifica come il metodo Update applica i risultati del comando a DataRow.

Metodi

Cancel()	Tenta di annullare l'esecuzione di una classe OdbcCommand.
CreateDbParameter()	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 OdbcParameter .
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da DbCommand)
Dispose(Boolean)	Rilascia le risorse non gestite usate da DbCommand e, facoltativamente, le risorse gestite. (Ereditato da DbCommand)
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)	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 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 il comando sull'oggetto di 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. 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 OdbcDataReader.
ExecuteReader(CommandBehavior)	Invia la proprietà CommandText alla proprietà Connection e compila una classe OdbcDataReader mediante uno dei valori di CommandBehavior.
ExecuteReaderAsync()	Versione asincrona di ExecuteReader, che esegue il comando sulla relativa connessione, restituendo un DbDataReader oggetto 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 oggetto 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 oggetto 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. Eventuali colonne o 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. Vengono ignorate tutte le altre colonne, righe e set di risultati. 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()	Obsoleti. 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()	Obsoleti. 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 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()	Crea una nuova istanza di un oggetto IDbDataParameter . (Ereditato da DbCommand)
IDbCommand.ExecuteReader()	Esegue la proprietà CommandText su Connection e compila IDataReader. (Ereditato da DbCommand)
IDbCommand.ExecuteReader(CommandBehavior)	Esegue la proprietà CommandText su Connection e compila IDataReader usando uno dei valori di CommandBehavior. (Ereditato da DbCommand)
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)

Metodi di estensione

ConfigureAwait(IAsyncDisposable, Boolean)

Consente di configurare la modalità di esecuzione delle espressioni await per le attività restituite da un elemento disposable asincrono.

Vedi anche

• OdbcDataAdapter
• OdbcConnection
• Esecuzione di un comando