IDbCommand IDbCommand IDbCommand 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, SqlCommand, et SqlDataReader.The following example creates instances of the derived classes, SqlConnection, SqlCommand, and SqlDataReader. L’exemple lit les données, leur écriture 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

Le IDbCommand interface permet à une classe qui hérite d’implémenter une classe de commande, qui représente une instruction SQL qui est exécutée sur 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écutant une commande.For more information about Command classes, see Executing a Command.

Une application ne crée pas une instance de la IDbCommand interface directement, mais crée une instance d’une classe qui implémente le IDbCommand interface.An application does not create an instance of the IDbCommand interface directly, but creates an instance of a class that implements the IDbCommand interface.

Classes qui implémentent IDbCommand doit implémenter tous ses membres et définissent généralement 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, le IDbCommand interface définit le ExecuteNonQuery (méthode).For example, the IDbCommand interface defines the ExecuteNonQuery method. À son tour, le SqlCommand classe hérite de cette méthode et définit également le ExecuteXmlReader (méthode).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 les fournisseurs de données .NET Framework, nommez la classe qui hérite sous la forme PrvClassnamePrv est le préfixe uniforme affecté à 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 le SqlCommand classe dans le System.Data.SqlClient espace de noms.For example, Sql is the prefix of the SqlCommand class in the System.Data.SqlClient namespace.

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

ÉlémentItem Description Description
PrvCommand()PrvCommand() Initialise une nouvelle instance de la classe PrvCommand.Initializes a new instance of the PrvCommand class.

PrvCommand (chaîne 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 PrvConnection.Initializes a new instance of the PrvCommand class with the text of the query and a PrvConnection.

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

Propriétés

CommandText CommandText CommandText 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 CommandTimeout CommandTimeout CommandTimeout

Obtient ou définit la durée d'attente qui précède le moment où il est mis fin à une tentative d'exécution d'une commande et où une erreur est générée.Gets or sets the wait time before terminating the attempt to execute a command and generating an error.

CommandType CommandType CommandType CommandType

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

Connection Connection Connection 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 Parameters Parameters Parameters

Obtient IDataParameterCollection.Gets the IDataParameterCollection.

Transaction Transaction Transaction 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 UpdatedRowSource UpdatedRowSource 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() Cancel() Cancel() Cancel()

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

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

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

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

(Inherited from IDisposable)
ExecuteNonQuery() ExecuteNonQuery() ExecuteNonQuery() 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() ExecuteReader() ExecuteReader() 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) ExecuteReader(CommandBehavior) ExecuteReader(CommandBehavior) 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() ExecuteScalar() ExecuteScalar() 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() Prepare() Prepare() 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