CDaoRecordset::Requery

 

Appelez la fonction membre pour régénérer () actualiser un recordset.

Syntaxe

virtual void Requery( );

Notes

Si les enregistrements retournés, le premier enregistrement redevient l'enregistrement courant.

Pour que le recordset reflète les ajouts et les suppressions que vous ou d'autres utilisateurs apportées à la source de données, vous devez régénérer le recordset en appelant Requery. Si le recordset est une feuille de réponse dynamique, elle reflète automatiquement les mises à jour que vous ou d'autres utilisateurs apportées à ses enregistrements existants (mais pas à ajouts). Si le recordset est un instantané, vous devez appeler Requery pour refléter les modifications apportées par d'autres utilisateurs ainsi que les ajouts et suppressions.

Pour une feuille de réponse dynamique ou un instantané, appelez Requery lorsque vous souhaitez reconstruire le recordset à l'aide de les valeurs de paramètre. Placez le nouveau filtre ou tri en définissant m_strFilter et m_strSort avant d'appeler Requery. Définissez les nouveaux paramètres en assignant de nouvelles valeurs aux membres de données de type paramètre avant d'appeler Requery.

Si la tentative de régénérer le recordset échoue, le recordset est fermé. Avant d'appeler Requery, vous pouvez déterminer si le recordset peut être actualisé en appelant la fonction membre de CanRestart . CanRestart ne garantit pas que Requery réussit.

Avertissement

Appel Requery uniquement après que vous avez appelé Ouvrir.

Notes

Appeler les signets DAO de modifications d' Actualiser .

Vous ne pouvez pas appeler Requery sur un recordset de type feuille de réponse dynamique ou de type instantané en appelant CanRestart retourne 0, vous ne pouvez pas non plus utiliser sur un recordset de type table.

Si IsBOF et IsEOF retournent une valeur différente de zéro après avoir appelé Requery, la requête n'a pas retourné un enregistrement et le recordset ne contient aucune donnée.

Pour des informations connexes, consultez la rubrique « actualiser la méthode » dans l'aide de DAO.

Configuration requise

Header: afxdao.h

Voir aussi

CDaoRecordset Class
Graphique hiérarchique
CDaoRecordset::CanRestart