Requery, 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.Requery Options  

Paramètres

Options
facultatif. Masque de bits contenant les 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 lors de sa conclusion. Les valeurs ExecuteOpenEnum d’adExecuteNoRecords ou d’adExecuteStream ne devraient pas être utilisées avec la méthode Requery.

Notes

Utilisez la méthode Requery pour actualiser l’intégralité du contenu d’un objet Recordset à partir de la source de données en réémettant la commande d’origine et en récupérant les données une seconde fois. L’appel de cette méthode équivaut à appeler successivement les méthodes Close et Open. Si vous modifiez l’enregistrement actif ou ajoutez un enregistrement, une erreur se produit.

Pendant que 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 modifier des propriétés du curseur et voir les résultats, vous devez utiliser la méthode Close afin que ces propriétés soient à nouveau en lecture/écriture. Vous pouvez ensuite modifier les paramètres de propriété et appeler la méthode Open pour rouvrir le curseur.

S'applique à

Recordset, objet (ADO)

Voir aussi

Exemple des méthodes Execute, Requery et Clear (VB)
Exemple des méthodes Execute, Requery et Clear (VBScript)
Exemple Execute, Requery et Clear (VC++)
CommandText, propriété (ADO)