virtuel BOOL Actualiser ( );
jeter ( CDBException, CMemoryException );
Valeur de retour
Différent de zéro si le jeu d'enregistrements a été reconstruite avec succès ; sinon 0.
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 d'un nouveau filtre ou tri ou nouvelles valeurs de paramètre. Définir le nouveau filtre ou la propriété sort en assignant des valeurs nouvelles m_strFilter et m_strSort avant d'appeler Requery. Définir les nouveaux paramètres en assignant des valeurs nouvelles de membres de données de paramètre avant d'appeler Requery. Si les chaînes de filtre et de tri sont inchangées, vous pouvez réutiliser la requête, ce qui améliore les performances.
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.
Exemple
Cet exemple recrée un objet recordset à appliquer un ordre de tri différent.
/ / Exemple pour CRecordset::Requery
CCustSet rsCustSet (&NULL) ;
/ / Ouvrir l'objet recordset
rsCustSet.Open () ;
/ / Utilisation de l'objet recordset...
/ / Définir l'ordre de tri et actualiser le jeu d'enregistrements
rsCustSet.m_strSort = « District, Last_Name » ;
Si (! rsCustSet.CanRestart ())
nbsp ; retour ; / / Impossible de lancer une nouvelle requête
Si (! rsCustSet.Requery ())
/ / Actualiser a échoué, donc prendre des mesures
Aperçu de CRecordset | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CRecordset::CanRestart, CRecordset::m_strFilter, CRecordset::m_strSort