Condividi tramite

CRecordset::SetBookmark

  • Articolo

 

Pubblicato: aprile 2016

Posizionare il recordset sul record che contiene il segnalibro specificato.

Sintassi

      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

Exception

Condition

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

Requisiti

Header: afxdb.h

Vedere anche

CRecordset Class
Grafico delle gerarchie
CRecordset::CanBookmark
CRecordset::GetBookmark
CRecordset::SetAbsolutePosition
CDatabase::GetBookmarkPersistence