Partager via

IDataParameter Interface

Définition

Espace de noms:
System.Data
Assemblys:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll
Source:
IDataParameter.cs
Source:
IDataParameter.cs

Représente un paramètre pour un objet Command, et éventuellement, son mappage aux DataSet colonnes ; et est implémenté par les fournisseurs de données .NET qui accèdent aux sources de données.

public interface class IDataParameter
public interface IDataParameter
type IDataParameter = interface
Public Interface IDataParameter
Dérivé

Exemples

L’exemple suivant crée plusieurs instances de la classe dérivée, SqlParametervia la SqlParameterCollection collection dans le SqlDataAdapter. Ces paramètres sont utilisés pour sélectionner des données à partir de la source de données et placer les données dans le DataSet. Cet exemple suppose qu’un DataSet et un SqlDataAdapter ont déjà été créés avec le schéma, les commandes et la connexion appropriés.

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);
}

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

Remarques

L’interface IDataParameter permet à une classe héritée d’implémenter une classe Parameter, qui représente un paramètre à un objet Command. Pour plus d’informations sur les classes De paramètres, consultez Configuration des paramètres et des types de données de paramètres.

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

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

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 dans le paramètre de formulaire Prv , 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 IDataParameter , vous devez implémenter les constructeurs suivants :

Élément Description
PrvParameter() Initialise une nouvelle instance de la classe Parameter.
PrvParameter(string name, PrvDbType dataType) Initialise une nouvelle instance de la classe Parameter avec le nom du paramètre et le type de données.
PrvParameter(nom de chaîne, valeur de l’objet) Initialise une nouvelle instance de la classe Parameter avec le nom du paramètre et un objet qui est la valeur du paramètre.
PrvParameter(string name, PrvDbType dataType, int size) Initialise une nouvelle instance de la classe Parameter avec le nom du paramètre, le type de données et la largeur.
PrvParameter(string name, PrvDbType dataType, int size, string srcColumn) Initialise une nouvelle instance de la classe DbParameter avec le nom du paramètre, le type de données, la largeur et le nom de colonne source.
PrvParameter(string parameterName, PrvDbType dbType, int size, ParameterDirection direction, Boolean isNullable, Byte precision, Byte scale, string srcColumn, DataRowVersion srcVersion, object value) Initialise une nouvelle instance de la OleDbParameter classe avec le nom du paramètre, le type de données, la largeur, le nom de colonne source, le sens du paramètre, la précision numérique et d’autres propriétés.

Propriétés

Nom Description
DbType

Obtient ou définit le DbType paramètre.
Direction

Obtient ou définit une valeur indiquant si le paramètre est un paramètre de valeur de retour d’entrée uniquement, de sortie uniquement, bidirectionnel ou de procédure stockée.
IsNullable

Obtient une valeur indiquant si le paramètre accepte des valeurs Null.
ParameterName

Obtient ou définit le nom du IDataParameter.
SourceColumn

Obtient ou définit le nom de la colonne source mappée au DataSet chargement ou au renvoi de la Valuecolonne source.
SourceVersion

Obtient ou définit la valeur à utiliser lors du DataRowVersion chargement Value.
Value

Obtient ou définit la valeur du paramètre.

S’applique à