S’applique à
|
Objet Form |
|
Objet Report |
La propriété ParamètresSaisie permet de spécifier ou déterminer les paramètres de saisie transmis à une instruction SQL dans la propriété Source d’un formulaire ou d’un état, ou d’une procédure stockée quand elle est utilisée en tant que source d’enregistrement dans un projet Microsoft Access (.adp). Chaîne en lecture/écriture.
expression.ParamètresSaisie
expression Obligatoire. Expression qui renvoie l’un des objets de la liste S’applique à.
Remarques
Vous pouvez définir cette propriété à l’aide de la feuille de propriétés ou d’un code Visual Basic pour Applications (VBA).
Utilisation avec une propriété Source :
Un exemple de chaîne de propriété ParamètresSaisie utilisé avec une instruction SQL dans la propriété Source utiliserait la syntaxe suivante.
state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Enter year of interest]
Cela aurait pour effet de définir le paramètre state sur la valeur actuelle du contrôle StateList et d’inviter l’utilisateur à entrer le paramètre salesyear. S’il y avait d’autres paramètres ne figurant pas dans cette liste, des valeurs par défaut leur seraient affectées.
La requête doit être exécutée avec un marqueur ? pour chaque paramètre autre que par défaut dans la liste ParamètresSaisie.
Une commande d’actualisation ou de réexécution de requête dans Microsoft Office Access 2007 déclencherait une nouvelle exécution de la requête. Les utilisateurs peuvent faire cela dans du code en appelant la méthode Recordset.Requery. Si la valeur d’un paramètre est dépendante d’un contrôle sur le formulaire, la valeur actuelle du contrôle est utilisée au moment de la réexécution de la requête. La requête n’est pas automatiquement réexécutée quand la valeur du contrôle change.
Utilisation avec une procédure stockée :
Un exemple de chaîne de propriété ParamètresSaisie utilisée avec une procédure stockée serait :
@state char=[Forms]![formname]![StateList], @salesyear smallint=[Forms]![formname]![Enter year of interest]
Cela aurait pour effet de définir le paramètre @state sur la valeur actuelle du contrôle StateList et d’inviter l’utilisateur à entrer le paramètre @salesyear. S’il y avait d’autres paramètres pour la procédure stockée ne figurant pas dans cette liste, des valeurs par défaut leur seraient affectées.
La procédure stockée serait exécutée à l’aide d’une chaîne de commande contenant la syntaxe {call} avec un marqueur ? pour chaque paramètre par défaut dans la liste ParamètresSaisie.
Une commande d’actualisation ou de réexécution de requête dans Access déclencherait une nouvelle exécution de la procédure stockée. Les utilisateurs peuvent faire cela dans du code en appelant la méthode Recordset.Requery. Si la valeur d’un paramètre est dépendante d’un contrôle sur le formulaire, la valeur actuelle du contrôle est utilisée au moment de la réexécution de la requête. La procédure stockée n’est pas automatiquement réexécutée quand la valeur du contrôle change.
Cette boîte de dialogue du générateur est appelée quand une procédure stockée est tout d’abord sélectionnée en tant que source d’enregistrement d’un formulaire si la procédure stockée comprend des paramètres. Après la création initiale de la chaîne ParamètresSaisie, cette même boîte de dialogue est utilisée en tant que générateur pour modifier la chaîne. Toutefois, dans ce cas, la liste des paramètres provient de ce qui existe déjà dans la chaîne.
Les valeurs des paramètres peuvent également être définies dans un code à l’aide des objets Commande et Parameter d’ActiveX Data Object (ADO). Si le résultat renvoie un jeu de résultats, un formulaire peut être lié à celui-ci en définissant la propriété Recordset du formulaire. Un codage ADO est la seule façon de traiter des procédures stockées qui ne retournent pas de jeux de résultats (telles que les requêtes action), qui renvoient des paramètres de sortie ou qui renvoient plusieurs jeux de résultats.
