CDaoRecordset::FindFirst

BOOL FindFirst (LPCTSTR lpszFilter);
jeter (CDaoException, CMemoryException);

Valeur de retour

Différent de zéro si les enregistrements correspondants sont trouvés, sinon 0.

Paramètres

lpszFilter

Une expression de chaîne (comme la clause WHERE dans une instruction SQL sans le mot ) utilisée pour localiser le dossier.

Remarques

Appelez cette fonction membre pour rechercher le premier enregistrement qui correspond à une condition spécifiée. La fonction de membre de FindFirst commence sa recherche dès le début de l'objet recordset et fouilles à la fin de l'objet recordset.

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

Si un enregistrement correspondant aux critères n'est pas localisé, le pointeur d'enregistrement actif est indéterminé et FindFirst renvoie zéro. Si le jeu d'enregistrements contient plus d'un dossier qui satisfait aux critères, que FindFirst localise la première occurrence, FindNext localise l'occurrence suivante et ainsi de suite.

Prude&ncenbsp ;  Si vous modifiez l'enregistrement en cours, veillez à enregistrer les modifications en appelant la fonction membre Update avant de vous déplacer vers un autre enregistrement. Si vous déplacez vers un autre dossier sans mettre à jour, vos modifications sont perdues sans avertissement.

Les fonctions de membre de trouver de recherche de l'emplacement et dans la direction spécifiée dans le tableau suivant:

Opérations de recherche Begin Direction de la recherche
FindFirst Début du jeu d'enregistrements Fin du jeu d'enregistrements
FindLast Fin du jeu d'enregistrements Début du jeu d'enregistrements
FindNext Enregistrement en cours Fin du jeu d'enregistrements
FindPrevious Enregistrement en cours Début du jeu d'enregistrements

&Nbsp important;  Lorsque vous appelez FindLast, le moteur de base de données Microsoft Jet entièrement remplit votre jeu d'enregistrements avant de commencer la recherche, si ce n'est pas déjà fait. La première fouille peut prendre plus longtemps que les recherches ultérieures.

En utilisant l'une des opérations de recherche n'appeler MoveFirst ou MoveNext, cependant, qui en fait tout simplement le premier ou le prochain enregistrement actuel sans spécifier une condition. Vous pouvez suivre une opération de recherche avec une opération de déplacement.

Gardez ce qui suit à l'esprit lors de l'utilisation des opérations de recherche:

Pour plus d'informations sur la recherche de documents, consultez l'article jeu d'enregistrements DAO : Navigation de jeu d'enregistrements dans le Guide du programmeur Visual C++. Pour plus d'informations, consultez la rubrique « FindFirst, FindLast, FindNext, FindPrevious méthodes » dans l'aide de DAO.

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

Voir aussinbsp ;Données, CDaoRecordset::FindLast, CDaoRecordset::Find&Next, CDaoRecordset::FindPrev

Index