void SetBookm&ark (const CDBVariantamp ; varBookmark );
jeter (CDBException, CMemoryException) ;
Paramètres
varBookmark
Une référence à un objet CDBVariant contenant la valeur de signet pour un enregistrement spécifique.
Remarques
Appelez cette fonction membre pour placer le jeu d'enregistrements dans le dossier contenant le signet spécifié. Pour déterminer si les signets sont pris en charge sur le jeu d'enregistrements, appelez CanBookmark. Pour rendre les signets disponibles, si elles sont étayées, vous devez définir l'option CRecordset::useBookmarks dans le paramètre dwOptions de la fonction membre Open.
&Notenbsp ; Si les signets sont non pris en charge ou non disponible, appeler SetBookmark donnera lieu à une levée d'exception. Signets ne sont pas supportées sur avant uniquement de jeux d'enregistrements.
Pour la première extraire le signet de l'enregistrement actuel, appelez GetBookmark, qui enregistre la valeur de signet dans un objet CDBVariant . Plus tard, vous pouvez revenir au dossier en appelant SetBookmark en utilisant la valeur enregistrée de signet.
&Notenbsp ; Après certaines opérations de jeu d'enregistrements, vous devez vérifier la persistance de signet avant d'appeler SetBookmark. Par exemple, si vous récupérer un signet avec GetBookmark et ensuite appelez Requery, le signet ne peut être valide. Appelez CDatabase::GetBookmarkPersistence pour vérifier si vous pouvez faire appel à SetBookmark.
Pour plus d'informations sur les signets et de navigation de jeu d'enregistrements, voir les articles jeu d'enregistrements : signets et Positions absolues (ODBC) et jeu d'enregistrements : défilement (ODBC) dans le Guide du programmeur Visual C++.
Aperçu de CRecordset | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CRecordset::CanBookmark, CRecordset::GetBookmark, CRecordset::SetAbsolutePosition, CDatabase::GetBookmarkPersistence