Méthode ObjectFrame.Requery (Access)

La méthode Requery met à jour les données sous-jacentes d'un contrôle spécifié du formulaire actif en actualisant la source de données pour le contrôle.

Syntaxe

expression. Nouvelle requête

Expression Variable qui représente un objet ObjectFrame .

Remarques

Utilisez cette méthode pour vous assurer qu’un formulaire ou un contrôle affiche les données les plus récentes.

La méthode Actualiser effectue une des actions suivantes :

• Réexécute la requête sur laquelle est basé le formulaire ou le contrôle.
• Affiche les enregistrement nouveaux ou modifiés, ou supprime les enregistrements supprimés de la table sur laquelle le formulaire ou contrôle est basé.
• Met à jour les enregistrements affichés en fonction des modifications apportées à la propriété Filter du formulaire.

Les contrôles basés sur une requête ou une table sont les suivants :

• zones de liste et zones de liste modifiable ;
• contrôles de sous-formulaire ;
• des objets OLE, tels que des graphiques ;
• Fonctions d'agrégation de contrôles dont la propriété ControlSource comprend des fonctions de regroupement domaine ou SQL.

Si vous spécifiez un autre type de contrôle pour l’objet spécifié par expression, la source d’enregistrement du formulaire est réexécutée.

Si l’objet spécifié par expression n’est pas lié à un champ dans une table ou une requête, la méthode Requery force un recalcul du contrôle.

Si vous omettez l’objet spécifié par expression, la méthode Requery réexécutera la source de données sous-jacente pour le formulaire ou le contrôle qui a le focus. Si le contrôle qui a le focus a une source d'enregistrement ou de ligne, il est actualisé ; sinon, les données du contrôle sont tout simplement actualisées.

Si un contrôle de sous-formulaire a le focus, cette méthode actualise uniquement la source d'enregistrement du sous-formulaire, et non le formulaire parent.

Remarque

• [!REMARQUE] La méthode Actualiser met à jour les données sous-jacentes d'un formulaire ou contrôle pour qu'elles reflètent les enregistrements nouveaux ou supprimés de la source d'enregistrement depuis la dernière requête. La méthode Actualiser affiche uniquement les modifications apportées au jeu d'enregistrements actuel ; elle ne reflète pas les enregistrements nouveaux ou supprimés de la source d'enregistrement. La méthode Repaint repeint simplement le formulaire spécifié et ses contrôles.
• La méthode Actualiser ne transmet pas le contrôle au système d’exploitation pour autoriser Windows à poursuivre le traitement des messages. Utilisez la fonction DoEvents si vous avez besoin de réattribuer provisoirement le contrôle au système d’exploitation.
• La méthode Requery est plus rapide que l’action Requery. Lorsque vous utilisez l'action Actualiser, Microsoft Access ferme la requête et la recharge à partir de la base de données. Lorsque vous utilisez la méthode Requery , Access réexécutera la requête sans la fermer et la recharger.

Exemple

L’exemple suivant utilise la méthode Requery pour réexécuter les données de la zone de liste EmployeeList sur un formulaire Employés .

Public Sub RequeryList() 
 
    Dim ctlCombo As Control 
 
    ' Return Control object pointing to a combo box. 
    Set ctlCombo = Forms!Employees!ReportsTo 
 
    ' Requery source of data for list box. 
    ctlCombo.Requery 
 
End Sub

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.