CRecordset::GetBookmark

void GetBookm&ark (CDBVariantamp ; varBookmark );
jeter (CDBException, CMemoryException) ;

Paramètres

varBookmark

Une référence à un objet CDBVariant représentant le signet de l'enregistrement en cours.

Remarques

Appelez cette fonction membre pour obtenir la valeur de signet de l'enregistrement actuel. 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 GetBookmark donnera lieu à une levée d'exception. Signets ne sont pas supportées sur avant uniquement de jeux d'enregistrements.

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

&Notenbsp ;  Après certaines opérations de jeu d'enregistrements, signets peuvent ne plus être valides. Par exemple, si vous appelez GetBookmark suivie d'actualiser, vous ne peut-être pas en mesure de reprendre le record avec SetBookmark. 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::SetBookmark, CDatabase::GetBookmarkPersistence

Index