CRecordset::GetBookmark

Ottiene il valore del segnalibro per il record corrente.

void GetBookmark( 
   CDBVariant& varBookmark  
);

Parametri

  • varBookmark
    Un riferimento a un oggetto CDBVariant che rappresenta il segnalibro nel record corrente.

Note

Per determinare se i segnalibri sono supportati nel recordset, chiamare CanBookmark.Per rendere disponibile se i segnalibri sono supportati, è necessario impostare l'opzione CRecordset::useBookmarks nel parametro dwOptions la funzione membro Apri.

[!NOTA]

Se i segnalibri non sono supportati o non disponibili, chiamare GetBookmark genereranno un'eccezione generata.I segnalibri non sono supportati nei recordset forward-only.

GetBookmark assegna il valore del segnalibro per il record corrente a un oggetto CDBVariant.Per tornare al record in qualsiasi momento dopo essere spostatosi a un altro record, chiamare SetBookmark con l'oggetto corrispondente CDBVariant.

[!NOTA]

Dopo alcune operazioni di recordset, i segnalibri possono non essere più validi.Ad esempio, se si chiama GetBookmark seguito da Requery, non è possibile tornare al record con SetBookmark.Chiamare CDatabase::GetBookmarkPersistence per controllare se è possibile chiamare in modo sicuro SetBookmark.

Per ulteriori informazioni sui bookmark e la navigazione del recordset, vedere gli articoli recordset: Segnalibri e absolute position (ODBC) e recordset: Scorrimento (ODBC).

Eccezioni

Questo metodo può generare eccezioni di tipo CDBException* e CMemoryException*.

Requisiti

Header: afxdb.h

Vedere anche

Riferimenti

Classe di CRecordset

Grafico della gerarchia

CRecordset::CanBookmark

CRecordset::SetBookmark

CDatabase::GetBookmarkPersistence