IDbCommand Interface

Définition

Représente une instruction SQL qui est exécutée alors qu’elle est connectée à une source de données, et qui est implémentée par les fournisseurs de données .NET Framework qui accèdent aux bases de données relationnelles.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
Dérivé
Implémente

Exemples

L’exemple suivant crée des instances des classes dérivées, SqlConnection, SqlCommandet SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. L’exemple lit les données, en les écrivant dans la console.The example reads through the data, writing it to the console. Enfin, l’exemple ferme le SqlDataReader, puis le 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

Remarques

L’interface IDbCommand permet à une classe qui hérite d’implémenter une classe Command, qui représente une instruction SQL exécutée au niveau d’une source de données.The IDbCommand interface enables an inheriting class to implement a Command class, which represents an SQL statement that is executed at a data source. Pour plus d’informations sur les classes de commande, consultez exécution d’une commande.For more information about Command classes, see Executing a Command.

Une application ne crée pas directement une instance de l’interface IDbCommand, mais crée une instance d’une classe qui implémente l’interface 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.

Les classes qui implémentent IDbCommand doivent implémenter tous ses membres, et en général définissent des membres supplémentaires pour ajouter des fonctionnalités spécifiques au fournisseur.Classes that implement IDbCommand must implement all its members, and typically define additional members to add provider-specific functionality. Par exemple, l’interface IDbCommand définit la méthode ExecuteNonQuery.For example, the IDbCommand interface defines the ExecuteNonQuery method. À son tour, la classe SqlCommand hérite de cette méthode et définit également la méthode ExecuteXmlReader.In turn, the SqlCommand class inherits this method, and also defines the ExecuteXmlReader method.

Notes pour les responsables de l’implémentation

Pour promouvoir la cohérence entre .NET Framework fournisseurs de données, nommez la classe qui hérite sous la forme PrvClassnamePrv est le préfixe uniforme donné à toutes les classes dans un espace de noms de fournisseur de données .NET Framework spécifique.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. Par exemple, Sql est le préfixe de la classe SqlCommand dans l’espace de noms System.Data.SqlClient.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

Lorsque vous héritez de l’interface IDbCommand, vous devez implémenter les constructeurs suivants :When you inherit from the IDbCommand interface, you should implement the following constructors:

ÉlémentItem DescriptionDescription
PrvCommand()PrvCommand() Initialise une nouvelle instance de la classe PrvCommand.Initializes a new instance of the PrvCommand class.
PrvCommand (string cmdText)PrvCommand(string cmdText) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête.Initializes a new instance of the PrvCommand class with the text of the query.
PrvCommand (chaîne cmdText, PrvConnection connexion)PrvCommand(string cmdText, PrvConnection connection) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête et un PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.
PrvCommand (string cmdText, PrvConnection Connection, PrvTransaction transaction)PrvCommand(string cmdText, PrvConnection connection, PrvTransaction transaction) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête, un PrvConnection et le PrvTransaction.Initializes a new instance of the PrvCommand class with the text of the query, a PrvConnection, and the PrvTransaction.

Propriétés

CommandText

Obtient ou définit la commande de texte à exécuter sur la source de données.Gets or sets the text command to run against the data source.

CommandTimeout

Obtient ou définit le délai d’attente (en secondes) avant de mettre fin à la tentative d’exécution d’une commande et de générer une erreur.Gets or sets the wait time (in seconds) before terminating the attempt to execute a command and generating an error.

CommandType

Indique ou spécifie comment la propriété CommandText est interprétée.Indicates or specifies how the CommandText property is interpreted.

Connection

Obtient ou définit le IDbConnection utilisé par cette instance du IDbCommand.Gets or sets the IDbConnection used by this instance of the IDbCommand.

Parameters

Obtient IDataParameterCollection.Gets the IDataParameterCollection.

Transaction

Récupère ou définit la transaction dans laquelle s’exécute l’objet Command d’un fournisseur de données .NET Framework.Gets or sets the transaction within which the Command object of a .NET Framework data provider executes.

UpdatedRowSource

Obtient ou définit la manière dont les résultats des commandes sont appliqués à DataRow quand ils sont utilisés par la méthode Update(DataSet) de DbDataAdapter.Gets or sets how command results are applied to the DataRow when used by the Update(DataSet) method of a DbDataAdapter.

Méthodes

Cancel()

Tente d'annuler l'exécution d'une activité IDbCommand.Attempts to cancels the execution of an IDbCommand.

CreateParameter()

Crée une nouvelle instance d’un objet IDbDataParameter .Creates a new instance of an IDbDataParameter object.

Dispose()

Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

(Hérité de IDisposable)
ExecuteNonQuery()

Exécute une instruction SQL sur l’objet Connection d’un fournisseur de données .NET Framework et retourne le nombre de lignes affectées.Executes an SQL statement against the Connection object of a .NET Framework data provider, and returns the number of rows affected.

ExecuteReader()

Exécute le CommandText contre le Connection et génère un IDataReader.Executes the CommandText against the Connection and builds an IDataReader.

ExecuteReader(CommandBehavior)

Exécute le CommandText sur le Connection, et génère un IDataReader à l’aide d’une des valeurs CommandBehavior.Executes the CommandText against the Connection, and builds an IDataReader using one of the CommandBehavior values.

ExecuteScalar()

Exécute la requête et retourne la première colonne de la première ligne du jeu de résultats retourné par la requête.Executes the query, and returns the first column of the first row in the resultset returned by the query. Les colonnes ou lignes supplémentaires sont ignorées.Extra columns or rows are ignored.

Prepare()

Crée une version préparée ou compilée de la commande sur la source de données.Creates a prepared (or compiled) version of the command on the data source.

S’applique à

Voir aussi