CRecordset::SetBookmark
Posizionare il recordset sul record che contiene il segnalibro specificato.
void SetBookmark(
const CDBVariant& varBookmark
);
Parametri
- varBookmark
Un riferimento a un oggetto CDBVariant che contiene il valore del segnalibro per un record specifico.
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 SetBookmark genereranno un'eccezione generata.I segnalibri non sono supportati nei recordset forward-only.
Alla prima recuperare il segnalibro per il record corrente, la chiamata GetBookmark, quindi il valore del segnalibro a un oggetto CDBVariant.Successivamente, è possibile restituire sul record chiamando SetBookmark utilizzando il valore salvato il segnalibro.
[!NOTA]
Dopo alcune operazioni di recordset, è necessario verificare la persistenza del segnalibro prima di chiamare SetBookmark.Ad esempio, se si recupera un segnalibro con GetBookmark e quindi chiamare Requery, il segnalibro può non essere più validi.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