IDbCommand IDbCommand IDbCommand IDbCommand Interface

Definizione

Rappresenta un'istruzione SQL eseguita durante la connessione a un'origine dati e viene implementata dai provider di dati .NET Framework che accedono a database relazionali.Represents an SQL statement that is executed while connected to a data source, and is implemented by .NET Framework data providers that access relational databases.

public interface class IDbCommand : IDisposable
public interface IDbCommand : IDisposable
type IDbCommand = interface
    interface IDisposable
Public Interface IDbCommand
Implements IDisposable
Derivato
Implementazioni

Esempi

L'esempio seguente crea le istanze di classi derivate SqlConnection, SqlCommand, e SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. L'esempio legge i dati e li scrive nella console.The example reads through the data, writing it to the console. Infine, l'esempio chiude il SqlDataReader, quindi il SqlConnection.Finally, the example closes the SqlDataReader, then the SqlConnection.

private static void ReadOrderData(string connectionString)
{
    string queryString = 
        "SELECT OrderID, CustomerID FROM dbo.Orders;";
    using (SqlConnection connection = new SqlConnection(
               connectionString))
    {
        SqlCommand command = new SqlCommand(
            queryString, connection);
        connection.Open();
        using(SqlDataReader reader = command.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine(String.Format("{0}, {1}",
                    reader[0], reader[1]));
            }
        }
    }
}
Public Sub ReadOrderData(ByVal connectionString As String)
    Dim queryString As String = _
        "SELECT OrderID, CustomerID FROM dbo.Orders;"
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)
        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
        Try
            While reader.Read()
                Console.WriteLine(String.Format("{0}, {1}", _
                    reader(0), reader(1)))
            End While
        Finally
            ' Always call Close when done reading.
            reader.Close()
        End Try
    End Using
End Sub

Commenti

Il IDbCommand interfaccia consente a una classe che eredita implementare una classe di comando, che rappresenta un'istruzione SQL che viene eseguita in un'origine dati.The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. Per altre informazioni sulle classi di comando, vedere eseguendo un comando.For more information about Command classes, see Executing a Command.

Un'applicazione non crea un'istanza del IDbCommand interfaccia direttamente, ma crea un'istanza di una classe che implementa il IDbCommand interfaccia.An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

Le classi che implementano IDbCommand deve implementare tutti i relativi membri e definire in genere membri aggiuntivi per aggiungere funzionalità specifiche del provider.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Ad esempio, il IDbCommand interfaccia definisce il ExecuteNonQuery (metodo).For example, the IDbCommand interface defines the ExecuteNonQuery method. A sua volta, il SqlCommand classe di questo metodo viene ereditato e definisce anche il ExecuteXmlReader (metodo).In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Note per gli implementatori

Per promuovere la coerenza tra i provider di dati .NET Framework, assegnare un nome alla classe che eredita il form PrvClassname in cui Prv è il prefisso uniform assegnato a tutte le classi in uno specifico spazio dei nomi provider di dati .NET Framework.To promote consistency among .NET Framework data providers, name the inheriting class in the form PrvClassname where Prv is the uniform prefix given to all classes in a specific .NET Framework data provider namespace. Ad esempio, Sql è il prefisso del SqlCommand classe la System.Data.SqlClient dello spazio dei nomi.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Quando si eredita dal IDbCommand interfaccia, è necessario implementare i costruttori seguenti:When you inherit from the IDbCommand interface, you should implement the following constructors:

ElementoItem DescrizioneDescription
PrvCommand()PrvCommand() Inizializza una nuova istanza della classe PrvCommand.Initializes a new instance of the PrvCommand class.

PrvCommand(string cmdText)PrvCommand(string cmdText) Inizializza una nuova istanza della classe PrvCommand con il testo della query.Initializes a new instance of the PrvCommand class with the text of the query.

PrvCommand (stringa cmdText, PrvConnection connessione)PrvCommand(string cmdText, PrvConnection connection) Inizializza una nuova istanza della classe PrvCommand con il testo della query e un oggetto PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.

PrvCommand (stringa cmdText, connessione PrvConnection, oggetto PrvTransaction transazione)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inizializza una nuova istanza della classe PrvCommand con il testo della query, un oggetto PrvConnection e l'oggetto PrvTransaction.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Proprietà

CommandText CommandText CommandText CommandText

Ottiene o imposta il comando di testo da eseguire sull'origine dati.Gets or sets the text command to run against the data source.

CommandTimeout CommandTimeout CommandTimeout CommandTimeout

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

CommandType CommandType CommandType CommandType

Indica o specifica come viene interpretata la proprietà CommandText.Indicates or specifies how the CommandText property is interpreted.

Connection Connection Connection Connection

Ottiene o imposta l'oggetto IDbConnection usato da questa istanza dell'oggetto IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

Parameters Parameters Parameters Parameters

Ottiene l'oggetto IDataParameterCollection.Gets the IDataParameterCollection.

Transaction Transaction Transaction Transaction

Ottiene o imposta la transazione all'interno della quale viene eseguito l'oggetto Command di un provider di dati .NET Framework.Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource UpdatedRowSource UpdatedRowSource UpdatedRowSource

Ottiene o imposta il modo in cui i risultati del comando vengono applicati a DataRow quando vengono usati dal metodo Update(DataSet) di DbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

Metodi

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

Tenta di annullare l'esecuzione di IDbCommand.Attempts to cancels the execution of an IDbCommand.

CreateParameter() CreateParameter() CreateParameter() CreateParameter()

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

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

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Inherited from IDisposable)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery()

Esegue un'istruzione SQL sull'oggetto Connection di un provider di dati .NET Framework e restituisce il numero di righe interessate.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

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

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

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

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 resultset returned by the query. Le colonne o le righe aggiuntive vengono ignorate.Extra columns or rows are ignored.

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.

Si applica a

Vedi anche