Méthode Requery

Met à jour les données d’un jeu d’enregistrements 'objet en réexécutant la requête sur laquelle l’objet est basé.

Syntaxe

  
recordset.Requery Options  

Paramètres

Options
Optionnel. Masque de bits qui contient des valeurs ExecuteOptionEnum et CommandTypeEnum affectant cette opération.

Remarque

Si options est définie sur adAsyncExecute, cette opération s’exécute de façon asynchrone et un événement RecordsetChangeComplete est émis lorsqu’il se termine. Les valeurs ExecuteOpenEnumd’adExecuteNoRecords ou adExecuteStream ne doivent pas être utilisées avec Requery.

Remarques

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éexécutant la commande d’origine et en récupérant les données une deuxième fois. L’appel de cette méthode équivaut à appeler les méthodes Close et Open en succession. Si vous modifiez l’enregistrement actif ou ajoutez un nouvel enregistrement, une erreur se produit.

Bien que l’objet Recordset soit ouvert, les propriétés qui définissent la nature du curseur (CursorType, LockType, MaxRecords, etc.) sont en lecture seule. Par conséquent, la méthode Requery ne peut actualiser que le curseur actuel. Pour modifier l’une des propriétés du curseur et afficher les résultats, vous devez utiliser la méthode Close afin que les propriétés deviennent de 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 à

objet Recordset (ADO)

Voir aussi

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