Partager via

Parameter, objet

  • Article

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.

Remarques

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 seule 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 parameter représentent des paramètres associés à des requêtes paramétrables, ou les arguments entrants/sortants et les valeurs de retour des procédures stockées. Selon la fonctionnalité du fournisseur, certaines collections, méthodes ou propriétés d’un objet Parameter peuvent ne pas être disponibles.

Avec les collections, méthodes et 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. Valeur est la propriété par défaut de l’objet Parameter.

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

  • Passez des données binaires ou 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 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 Parameter objets 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 retourner 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

objet de commande (ADO)
Méthode CreateParameter (ADO)
Parameters Collection (ADO)
Properties, collection (ADO)