Propriété Form.InputParameters (Access)

Utilisez la propriété InputParameters pour spécifier ou déterminer les paramètres d’entrée passés à une instruction SQL dans la propriété RecordSource d’un formulaire ou d’un état, ou une procédure stockée lorsqu’elle est utilisée comme source d’enregistrement dans un projet Microsoft Access (.adp). String en lecture/écriture.

Syntaxe

expression. InputParameters

expressionVariable qui représente un objetForm.

Remarques

En cas d’utilisation avec une propriété RecordSource

Voici un exemple d'utilisation de la chaîne de la propriété InputParameters avec une instruction SQL dans la propriété RecordSource employant la syntaxe suivante :

state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Enter year of interest]

Ainsi, le paramètre d’état est défini sur la valeur actuelle du contrôle StateList et l’utilisateur est invité à entrer le paramètre salesyear . Les éventuels autres paramètres ne figurant pas dans cette liste prennent leurs valeurs par défaut.

La requête doit être exécutée avec un marqueur pour chaque paramètre autre que celui par défaut dans la liste InputParameters .

Une commande d’actualisation ou de requête (via un menu, un clavier ou une barre de navigation) dans Access doit déclencher une réexécutation de la requête. Les utilisateurs peuvent le faire dans le code en appelant la méthode Requery standard. Si la valeur d'un paramètre est liée à un contrôle du formulaire, la valeur en cours du contrôle est utilisée au moment où la requête est exécutée de nouveau. La requête n'est pas automatiquement réexécutée quand la valeur du contrôle change.

En cas d’utilisation avec une procédure stockée

Un exemple de chaîne de propriété InputParameters utilisée avec une procédure stockée utilise la syntaxe suivante.

@state char=[Forms]![formname]![StateList], @salesyear smallint=[Forms]![formname]![Enter year of interest]

Le paramètre est @state alors défini sur la valeur actuelle du contrôle StateList et l’utilisateur est invité à entrer le @salesyear paramètre. Si d’autres paramètres de la procédure stockée ne figuraient pas dans cette liste, les valeurs par défaut sont affectées.

La procédure stockée doit être exécutée à l’aide d’une chaîne de commande contenant la syntaxe {call } avec un marqueur pour chaque paramètre non défini par défaut dans la liste InputParameters .

Une commande d’actualisation ou de requête (via un menu, un clavier ou une barre de navigation) dans Access doit déclencher une réexécutation de la procédure stockée. Les utilisateurs peuvent le faire dans le code en appelant la méthode Requery standard. Si la valeur d'un paramètre est liée à un contrôle du formulaire, la valeur en cours du contrôle est utilisée au moment où la requête est exécutée de nouveau. 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 la première fois qu'une procédure stockée est sélectionnée comme source d'enregistrements d'un formulaire, à condition que la procédure stockée possède des paramètres. Dès que la chaîne InputParameters est créée, cette même boîte de dialogue est utilisée comme générateur pour modifier la chaîne. Dans ce cas, toutefois, la liste des paramètres provient de ce qui existe déjà dans la chaîne.

Les valeurs de paramètre peuvent également être définies dans le code à l’aide des objets De commande et Paramètre de l’objet de données ActiveX (ADO). Si le résultat retourne un jeu de résultats, un formulaire peut y être lié en définissant la propriété Recordset du formulaire. Le codage ADO est le seul moyen de gérer les procédures stockées qui ne retournent pas de jeux de résultats tels que les requêtes d’action, celles qui retournent des paramètres de sortie ou celles qui retournent plusieurs jeux de résultats.

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.