OdbcCommand OdbcCommand OdbcCommand OdbcCommand 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. Questa classe non può essere ereditata.This class cannot be inherited.

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

Esempi

Nell'esempio seguente viene ExecuteNonQueryutilizzato.The following example uses 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:The OdbcCommand class provides the following methods for executing commands against a data source:

ElementoItem DescriptionDescription
ExecuteReader Esegue i comandi che restituiscono righe.Executes commands that return rows.
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 CommandText la proprietà e riutilizzare l' OdbcCommand oggetto.You can reset the CommandText property and reuse the OdbcCommand object. Tuttavia, OdbcDataReader prima di poter eseguire un comando nuovo o precedente, è necessario chiudere.However, you must close the OdbcDataReader before you can execute a new or previous command.

Se l'esecuzione del comando causa un errore OdbcException irreversibile, ad esempio un livello di gravità SQL Server di 20 OdbcConnection o più, può chiudere.If execution of the command causes a fatal OdbcException such as a SQL Server severity level of 20 or more, OdbcConnection may close. L'utente può tuttavia riaprire la connessione e continuare.However, the user can reopen the connection and continue.

Costruttori

OdbcCommand() OdbcCommand() OdbcCommand() OdbcCommand()

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

OdbcCommand(String) OdbcCommand(String) OdbcCommand(String) OdbcCommand(String)

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

OdbcCommand(String, OdbcConnection) OdbcCommand(String, OdbcConnection) OdbcCommand(String, OdbcConnection) OdbcCommand(String, OdbcConnection)

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

OdbcCommand(String, OdbcConnection, OdbcTransaction) OdbcCommand(String, OdbcConnection, OdbcTransaction) OdbcCommand(String, OdbcConnection, OdbcTransaction) OdbcCommand(String, OdbcConnection, OdbcTransaction)

Inizializza una nuova istanza della classe OdbcCommand con il testo della query, un oggetto OdbcConnection e l'oggetto Transaction.Initializes a new instance of the OdbcCommand class with the text of the query, an OdbcConnection object, 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 una stored procedure da eseguire sull'origine dati.Gets or sets the SQL statement or stored procedure to execute against 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 OdbcConnection usato da questa istanza dell'oggetto OdbcCommand.Gets or sets the OdbcConnection used by this instance of the OdbcCommand.

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 visibile in un controllo di interfaccia personalizzato.Gets or sets a value that indicates whether the command object should be visible in a customized interface 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 OdbcParameterCollection.Gets the OdbcParameterCollection.

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 OdbcTransaction in cui viene eseguito OdbcCommand.Gets or sets the OdbcTransaction within which the OdbcCommand executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Ottiene o imposta un valore che specifica come il metodo Update applica i risultati del comando a DataRow.Gets or sets a value that specifies how the Update method should apply command results to the DataRow.

Metodi

Cancel() Cancel() Cancel() Cancel()

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

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 OdbcParameter.Creates a new instance of an OdbcParameter 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 OdbcDataReader.Sends the CommandText to the Connection and builds an OdbcDataReader.

ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior)

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

Esegue la proprietà CommandText su Connection e compila IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior) IDbCommand.ExecuteReader(CommandBehavior)

Esegue CommandText su Connection e compila un IDataReader usando il comportamento specificato.Executes the CommandText against the Connection, and builds an IDataReader using the specified behavior.

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