Partager via

CRecordset::GetBookmark

  • Article

 

Obtient la valeur du signet de l'enregistrement actuel.

Syntaxe

      void GetBookmark( 
   CDBVariant& varBookmark  
);

Paramètres

  • varBookmark
    Une référence à un objet de CDBVariant représentant le signet sur l'enregistrement courant.

Notes

Pour déterminer si les signets sont pris en charge dans le recordset, appelez CanBookmark.Pour rendre les signets disponibles s'ils sont pris en charge, vous devez définir l'option de CRecordset::useBookmarks dans le paramètre d' dwOptions de la fonction membre d' Ouvrez .

Notes

Si les signets sont non pris en charge ou non disponibles, appeler GetBookmark entraîne une exception est levée.Les signets ne sont pas pris en charge sur les recordsets en avant seulement.

GetBookmark assigne la valeur du signet de l'enregistrement actuel à un objet d' CDBVariant .Pour revenir à cet enregistrement à tout moment après avoir déplacé dans un autre enregistrement, appelez SetBookmark avec l'objet correspondant d' CDBVariant .

Notes

Après certaines opérations de recordset, les signets ne peuvent plus être valides.Par exemple, si vous appelez GetBookmark suivi de Requery, vous ne pouvez pas pouvoir revenir à l'enregistrement avec SetBookmark.Appelez CDatabase::GetBookmarkPersistence pour vérifier si vous pouvez appeler sans risque SetBookmark.

Pour plus d'informations sur les signets et la navigation au sein d'un recordset, consultez les articles recordset : Signets et positions absolues (ODBC) et recordset : Défilement (ODBC).

Exceptions

Exception

Condition

Cette méthode peut lever des exceptions de type CDBException* et CMemoryException*.

Configuration requise

Header: afxdb.h

Voir aussi

CRecordset Class
Graphique hiérarchique
CRecordset::CanBookmark
CRecordset::SetBookmark
CDatabase::GetBookmarkPersistence