Partager via


CDaoRecordset::FindNext

Appelez la fonction membre pour rechercher l'enregistrement suivant qui correspond à un état spécifié.

BOOL FindNext( 
   LPCTSTR lpszFilter  
);

Paramètres

  • lpszFilter
    Une expression de chaîne (comme la clause WHERE dans une instruction SQL sans mot WHERE) utilisé pour localiser l'enregistrement.

Valeur de retour

Une valeur différente de zéro si correspondant aux enregistrements sont détectés, sinon 0.

Notes

La fonction membre d' FindNext commence la recherche à l'enregistrement actif et des recherches à la fin du recordset.

Si vous souhaitez inclure tous les enregistrements de votre recherche (pas seulement ceux qui répondent à une condition spécifique) utilisez l'une des opérations de déplacement pour passer d'un enregistrement à l'autre. Pour localiser un enregistrement dans un recordset de type table, appelez la fonction membre d' Seek .

Si une correspondance d'enregistrement des critères n'est pas localisée, le pointeur d'enregistrement actif est retourne zéro indéterminés, et d' FindNext . Si le recordset contient plusieurs rapports qui répond aux critères, FindFirst recherche la première occurrence, FindNext recherche l'occurrence suivante, et ainsi de suite.

Avertissement

Si vous modifiez l'enregistrement actif, assurez -vous que vous enregistrez les modifications en appelant la fonction membre de Mettre à jour avant de déplacer vers un autre enregistrement.Si vous accédez à un autre enregistrement sans mettre à jour, vos modifications sont perdues sans avertissement.

L'une des opérations de recherche n'est pas le même que l'appel MoveFirst ou MoveNext, toutefois, ce qui rend simplement le premier ou l'autre en cours de enregistrement sans spécifier une condition. Vous pouvez suivre une opération de recherche avec une opération de déplacement.

Conservez le texte suivant à l'esprit lors de l'utilisation des opérations de recherche :

  • Si Rechercher retourne une valeur différente de zéro, l'enregistrement en cours n'est pas défini. Dans ce cas, vous devez positionner le pointeur d'enregistrement actif vers un enregistrement valide.

  • Vous ne pouvez pas utiliser une opération de recherche à un recordset de type instantané de défilement en avant seulement.

  • Vous devez utiliser le format de date.. les US (mois jour an) lorsque vous recherchez des champs contenant des dates, même si vous n'utilisez pas la version américain.. du moteur de base de données Microsoft Jet ; sinon, la mise en correspondance des enregistrements ne peut être trouvé.

  • Lorsque vous utilisez des bases de données ODBC et pour les feuilles de réponse dynamiques, vous pouvez découvrir qu'il utilisation des opérations de recherche est lente, surtout lorsque vous travaillez avec de grands recordsets. Vous pouvez améliorer les performances en utilisant des requêtes SQL à ORDERpersonnaliséBY ou clauses WHERE, requêtes avec paramètres, ou objets de CDaoQuerydef qui récupèrent les enregistrements indexés spécifiques.

Pour des informations connexes, consultez la rubrique « FindFirst, FindLast, FindNext, méthodes de FindPrevious » dans l'aide de DAO.

Configuration requise

Header: afxdao.h

Voir aussi

Référence

CDaoRecordset, classe

Graphique de la hiérarchie

CDaoRecordset::Find

CDaoRecordset::FindFirst

CDaoRecordset::FindLast

CDaoRecordset::FindPrev