IDbCommand Interfaccia

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

Nell'esempio seguente vengono create istanze delle classi derivate, SqlConnection, SqlCommande 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

L'interfaccia IDbCommand consente a una classe che eredita di implementare una classe Command, che rappresenta un'istruzione SQL 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 ulteriori informazioni sulle classi di comando, vedere esecuzione di un comando.For more information about Command classes, see Executing a Command.

Un'applicazione non crea direttamente un'istanza dell'interfaccia IDbCommand, ma crea un'istanza di una classe che implementa l'interfaccia IDbCommand.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 devono implementare tutti i relativi membri e in genere definiscono 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, l'interfaccia IDbCommand definisce il metodo ExecuteNonQuery.For example, the IDbCommand interface defines the ExecuteNonQuery method. A sua volta, la classe SqlCommand eredita questo metodo e definisce anche il metodo ExecuteXmlReader.In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Note per gli implementatori

Per promuovere la coerenza tra .NET Framework provider di dati, denominare la classe che eredita nel formato PrvClassname dove Prv è il prefisso uniforme assegnato a tutte le classi in uno spazio dei nomi del provider di dati .NET Framework specifico.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 della classe SqlCommand nello spazio dei nomi System.Data.SqlClient.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

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

ElementoItem DescriptionDescription
PrvCommand()PrvCommand() Inizializza una nuova istanza della classe PrvCommand.Initializes a new instance of the PrvCommand class.
PrvCommand (stringa 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, connessione PrvConnection)PrvCommand(string cmdText, PrvConnection connection) Inizializza una nuova istanza della classe PrvCommand con il testo della query e un PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.
PrvCommand (stringa cmdText, connessione PrvConnection, transazione PrvTransaction)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Inizializza una nuova istanza della classe PrvCommand con il testo della query, PrvConnection e PrvTransaction.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Proprietà

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

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

CommandType

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

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

Ottiene l'oggetto IDataParameterCollection.Gets the IDataParameterCollection.

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

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()

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

CreateParameter()

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

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.

(Ereditato da IDisposable)
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()

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

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()

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()

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