CDaoRecordset::Requery

virtual void Requery () ;
jeter (CDaoException, CMemoryException);

Remarques

Appelez cette fonction membre pour reconstruire (actualisation) un jeu d'enregistrements. Si tous les enregistrements sont retournés, le premier enregistrement devient l'enregistrement courant.

Pour que le jeu d'enregistrements refléter les ajouts et les suppressions que vous ou autres utilisateurs sont à la source de données, vous devez reconstruire l'objet recordset par appeler Requery. Si le jeu d'enregistrements est un dynaset, elle reflète automatiquement les mises à jour que vous ou autres utilisateurs font ses enregistrements existants (mais pas les ajouts). Si le jeu d'enregistrements est un instantané, vous devez appeler Requery pour refléter les modifications apportées par les autres utilisateurs ainsi que des ajouts et des suppressions.

Pour une feuille de réponse dynamique ou un instantané, appeler Requery n'importe quel moment que vous souhaitez régénérer l'objet recordset à l'aide des valeurs de paramètre. Définir le nouveau filtre ou tri par paramètre m_strFilter et m_strSort avant d'appeler Requery. Définir de nouveaux paramètres en assignant des valeurs nouvelles de membres de données de paramètre avant d'appeler Requery.

Cas d'échec de la tentative de reconstruire l'objet recordset, l'objet recordset est fermé. Avant de vous appeler Requery, vous pouvez déterminer si le jeu d'enregistrements peut être actualisé en appelant la fonction membre CanRestart . CanRestart ne garantit pas que Requery réussira.

Prude&ncenbsp ;  Appeler Requery seulement après que vous avez appelé Open.

Vous ne pouvez pas appeler Requery sur un type de feuille de réponse dynamique ou recordset de type instantané si vous appelez CanRestart renvoie la valeur 0, ni pouvez vous l'utiliser sur un objet recordset de type table.

Si fois IsBOF et IsEOF retournent zéro après que vous appeler Requery, la requête ne renvoie que tous les enregistrements et le jeu d'enregistrements ne contient aucuns données.

Pour plus d'informations sur la mise à jour de données, consultez l'article jeu d'enregistrements DAO : opérations de jeu d'enregistrements dans le Guide du programmeur Visual C++. Pour plus d'informations, consultez la rubrique « Méthode Requery » dans l'aide de DAO.

Aperçu de CDaoRecordset |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CDaoRecordset::CanRestart

Index