IDbCommand Interface

Définition

Représente une instruction SQL exécutée dans le cadre de la connexion à une source de données ; est implémenté par les fournisseurs de données .NET qui accèdent aux bases de données relationnelles.

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. L’exemple lit les données et les écrit dans la console. Enfin, l’exemple ferme le SqlDataReader, puis le 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 héritée d’implémenter une classe Command, qui représente une instruction SQL exécutée sur une source de données. Pour plus d’informations sur les classes command, consultez Exécution d’une commande.

Une application ne crée pas directement de instance de l’interfaceIDbCommand, mais crée un instance d’une classe qui implémente l’interfaceIDbCommand.

Les classes qui implémentent IDbCommand doivent implémenter tous ses membres et définir généralement des membres supplémentaires pour ajouter des fonctionnalités spécifiques au fournisseur. Par exemple, l’interface IDbCommand définit la ExecuteNonQuery méthode . À son tour, la SqlCommand classe hérite de cette méthode et définit également la ExecuteXmlReader méthode .

Notes pour les responsables de l’implémentation

Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, nommez la classe héritée 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. Par exemple, Sql est le préfixe de la SqlCommand classe dans l’espace de System.Data.SqlClient noms .

Lorsque vous héritez de l’interface IDbCommand , vous devez implémenter les constructeurs suivants :

Élément Description
PrvCommand() Initialise une nouvelle instance de la classe PrvCommand.
PrvCommand(string cmdText) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête.
PrvCommand(string cmdText, connexion PrvConnection) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête et un PrvConnection.
PrvCommand(string cmdText, connexion PrvConnection, transaction PrvTransaction) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête, un PrvConnection et le PrvTransaction.

Propriétés

CommandText

Obtient ou définit la commande de texte à exécuter sur la source de données.

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.

CommandType

Indique ou spécifie comment la propriété CommandText est interprétée.

Connection

Obtient ou définit le IDbConnection utilisé par cette instance du IDbCommand.

Parameters

Obtient 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.

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.

Méthodes

Cancel()

Tente d'annuler l'exécution d'une activité IDbCommand.

CreateParameter()

Crée une nouvelle instance d’un objet IDbDataParameter .

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.

(Hérité de IDisposable)
ExecuteNonQuery()

Exécute une instruction SQL sur l’objet Connection d’un fournisseur de données .NET et retourne le nombre de lignes affectées.

ExecuteReader()

Exécute le CommandText contre le Connection et génère un IDataReader.

ExecuteReader(CommandBehavior)

Exécute le CommandText sur le Connection, et génère un IDataReader à l’aide d’une des valeurs CommandBehavior.

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. Les colonnes ou lignes supplémentaires sont ignorées.

Prepare()

Crée une version préparée ou compilée de la commande sur la source de données.

S’applique à

Voir aussi