IDbCommand Interface

Définition

Espace de noms:
System.Data
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Représente une instruction SQL exécutée lors de la connexion à une source de données et implémentée par .NET fournisseurs de données 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
IDisposable

Exemples

L’exemple suivant crée des instances des classes dérivées, SqlConnection, SqlCommandet SqlDataReader. L’exemple lit les données, en l’écrivant 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 à 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 une instance de l’interface IDbCommand , mais crée une instance d’une classe qui implémente l’interface IDbCommand .

Les classes qui implémentent doivent implémenter IDbCommand tous ses membres et définissent 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 PrvClassname où Prv est le préfixe uniforme donné à toutes les classes d’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 System.Data.SqlClient de 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 une PrvConnection.
PrvCommand(string cmdText, connexion PrvConnection, transaction PrvTransaction) Initialise une nouvelle instance de la classe PrvCommand avec le texte de la requête, une PrvConnection et le PrvTransaction.

Propriétés

Nom Description
CommandText

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

Obtient ou définit le temps d’attente (en secondes) avant de terminer la tentative d’exécution d’une commande et de générer une erreur.
CommandType

Indique ou spécifie la façon dont la CommandText propriété est interprétée.
Connection

Obtient ou définit l’utilisé IDbConnection par cette instance du IDbCommand.
Parameters

Obtient le IDataParameterCollection.
Transaction

Obtient ou définit la transaction dans laquelle l’objet Command d’un fournisseur de données .NET s’exécute.
UpdatedRowSource

Obtient ou définit la façon dont les résultats de commande sont appliqués au DataRow moment où ils sont utilisés par la Update(DataSet) méthode d’un DbDataAdapter.

Méthodes

Nom Description
Cancel()

Tente d’annuler l’exécution d’un IDbCommand.
CreateParameter()

Crée une instance d’un IDbDataParameter objet.
Dispose()

Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation 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 l’objet CommandText sur le Connection fichier et génère un IDataReader.
ExecuteReader(CommandBehavior)

Exécute la valeur par rapport à CommandText l’élément , et génère une Connection opération à l’aide IDataReaderde l’une CommandBehavior des valeurs.
ExecuteScalar()

Exécute la requête et retourne la première colonne de la première ligne dans le 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