Propriété Form.InputParameters (Access)

Utilisez la propriété InputParameters pour spécifier ou déterminer les paramètres d’entrée qui sont transmis à 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

Lorsqu’il est utilisé 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]

Ceci entraînerait la définition du paramètre state sur la valeur actuelle du contrôle StateList et l’utilisateur serait 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 réinterrogation (via le menu, le clavier ou la barre de navigation) dans Access doit déclencher une réexécution 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.

Lorsqu’il est utilisé avec une procédure stockée

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

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

Cela entraînerait la définition du @state paramètre sur la valeur actuelle du contrôle StateList et l’utilisateur serait invité à entrer le @salesyear paramètre. S’il existe d’autres paramètres de la procédure stockée qui ne figurent pas dans cette liste, les valeurs par défaut leur 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 par défaut dans la liste InputParameters .

Une commande d’actualisation ou de réinterrogation (via le menu, le clavier ou la barre de navigation) dans Access doit déclencher une réexécution 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, cependant, la liste des paramètres provient de ce qui existe déjà dans la chaîne.

Les valeurs de paramètre sont également définissables dans le code à l’aide de la commande de l’objet de données ActiveX (ADO) et des objets Paramètre . Si le résultat renvoie un jeu de résultats, un formulaire peut y être lié en définissant la propriété Jeu d’enregistrements du formulaire. Le codage ADO est le seul moyen de gérer les procédures stockées qui ne renvoient pas de jeux de résultats tels que les requêtes d’action, celles qui renvoient des paramètres de sortie ou celles qui renvoient 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.