L'interface IDataParameter permet à une classe qui hérite d'implémenter une classe Parameter représentant un paramètre d'un objet Command. Pour plus d'informations sur les classes Parameter, consultez Utilisation des procédures stockées avec une commande. Pour plus d'informations sur l'implémentation de fournisseurs de données .NET Framework, consultez Implementing a .NET Framework Data Provider.

Une application ne crée pas directement d'instance de l'interface IDataParameter, mais crée une instance d'une classe qui hérite de IDataParameter.

Les classes qui héritent de IDataParameter doivent implémenter les membres hérités et définissent généralement des membres supplémentaires pour ajouter des fonctionnalités propres au fournisseur. Par exemple, l'interface IDataParameter définit la propriété DbType. À son tour, la classe OleDbParameter hérite de cette propriété et définit également la propriété OleDbType.

Remarques à l'attention des implémenteurs Pour promouvoir la cohérence entre les fournisseurs de données .NET Framework, nommez la classe qui hérite sous la forme Prv Parameter, où Prv est le préfixe uniforme affecté à toutes les classes d'un espace de noms de fournisseurs de données .NET Framework spécifique. Par exemple, Sql est le préfixe de la classe SqlCommand dans l'espace de noms System.Data.SqlClient. Si vous héritez de l'interface IDataParameter, il est recommandé d'implémenter les constructeurs suivants :

L'exemple suivant crée plusieurs instances de la classe dérivée, SqlParameter, à l'aide de la collection SqlParameterCollection au sein de SqlDataAdapter. Ces paramètres sont utilisés pour sélectionner des données dans la source de données et les placer dans le DataSet. Cet exemple part du principe que DataSet et SqlDataAdapter ont déjà été créés avec le schéma, les commandes et la connexion appropriés.

Public Sub AddSqlParameters()
    ' ...
    ' create categoriesDataSet and categoriesAdapter
    ' ...
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"
    categoriesAdapter.SelectCommand.Parameters.Add( _
        "@SerialNum", SqlDbType.Int).Value = 239
    
    categoriesAdapter.Fill(categoriesDataSet)
End Sub  

public void AddSqlParameters() 
{
// ...
// create categoriesDataSet and categoriesAdapter
// ...

  categoriesAdapter.SelectCommand.Parameters.Add(
    "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters";
  categoriesAdapter.SelectCommand.Parameters.Add(
    "@SerialNum", SqlDbType.Int).Value = 239;
  categoriesAdapter.Fill(categoriesDataSet);

}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

.NET Compact Framework