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

Vedere anche

Riferimenti

Classe di CRecordset

Grafico della gerarchia

CRecordset::CanBookmark

CRecordset::GetBookmark

CRecordset::SetAbsolutePosition

CDatabase::GetBookmarkPersistence