Partager via


Objet Parameter

Représente un paramètre ou un argument associé à un objet Command, en fonction d’une requête paramétrable ou d’une procédure stockée.

Notes

De nombreux fournisseurs prennent en charge les commandes paramétrables. Il s’agit de commandes dans lesquelles l’action souhaitée est définie une fois, mais les variables (ou paramètres) sont utilisées pour modifier certains détails de la commande. Par exemple, une instruction SQL SELECT peut utiliser un paramètre pour définir les critères correspondants d’une clause WHERE, et une autre pour définir le nom de colonne d’une clause SORT BY.

Les objets Paramater représentent des paramètres associés à des requêtes paramétrables, ou les arguments in/out et les valeurs de retour des procédures stockées. Avec les collections, les méthodes et les propriétés d’un objet Parameter, vous pouvez effectuer les opérations suivantes :

Avec les collections, les méthodes et les propriétés d’un objet Parameter, vous pouvez effectuer les opérations suivantes :

  • Définissez ou retournez le nom d’un paramètre avec la propriété Name.

  • Définissez ou retournez la valeur d’un paramètre avec la propriété Value. Value est la propriété par défaut de l’objet Parameter.

  • Définissez ou retournez des caractéristiques de paramètre avec les propriétés Attributs, Direction, Précision, NumericScale, Size et Type.

  • Passez des données binaires ou de caractères longues à un paramètre avec la méthode AppendChunk.

  • Accédez aux attributs spécifiques au fournisseur à l’aide de la collection Properties.

Si vous connaissez les noms et les propriétés des paramètres associés à la procédure stockée ou à la requête paramétrable que vous souhaitez appeler, vous pouvez utiliser la méthode CreateParameter pour créer des objets Parameter avec les paramètres de propriété appropriés et utiliser la méthode Append pour les ajouter à la collection Parameters. Cela vous permet de définir et de renvoyer des valeurs de paramètre sans avoir à appeler la méthode Refresh sur la collection Parameters pour récupérer les informations de paramètre du fournisseur, une opération potentiellement gourmande en ressources.

L’objet Parameter n’est pas sécurisé pour le script.

Cette section contient la rubrique suivante.

Voir aussi

Command, objet (ADO)
CreateParameter, méthode (ADO)
Parameters, collection (ADO)
Properties, collection (ADO)