Méthode Requery (ADO)
S’applique à : Access 2013, Office 2013
Cette méthode met à jour les données d’un objet Recordset en réexécutant la requête sur laquelle l’objet est basé.
Syntaxe
recordset. Options de requête
Paramètres
| Nom | Description |
|---|---|
| Options | Facultatif. Masque de bits contenant des valeurs ExecuteOptionEnum et CommandTypeEnum affectant cette opération. |
Remarque
Si Options est défini sur adAsyncExecute, cette opération s’exécute de façon asynchrone et un événement RecordsetChangeComplete est émis à sa fin.
Les valeurs adExecuteNoRecords ou adExecuteStream de l'énumération ExecuteOpenEnum ne doivent pas être utilisées avec Requery.
Remarques
Faites appel à la méthode Requery pour actualiser tout le contenu d'un objet Recordset à partir de la base de données en réexécutant la commande d'origine et en extrayant les données une seconde fois. L'appel de cette méthode revient à appeler successivement les méthodes Close et Open. Si vous modifiez l'enregistrement actif ou que vous ajoutez un nouvel enregistrement, une erreur se produit.
Lorsque l’objet Recordset est ouvert, les propriétés qui définissent la nature du curseur (CursorType, LockType, MaxRecords, etc.) sont en lecture seule. Ainsi, la méthode Requery ne peut actualiser que le curseur actif. Pour changer des propriétés du curseur et afficher les résultats ainsi obtenus, vous devez faire appel à la méthode Close afin que les propriétés soient à nouveau en lecture-écriture. Vous pouvez alors changer les paramètres des propriétés et appeler la méthode Open pour rouvrir le curseur.