public st&atic void SetBookmark (const CDBVariantamp; varBookmark );
gettare (CDBException, CMemoryException);
Parametri
varBookmark
Un riferimento a un oggetto CDBVariant contenente il valore di segnalibro per un record specifico.
Osservazioni
Chiamare questa funzione membro per posizionare il recordset sul record contenenti il segnalibro specificato. Per determinare se i segnalibri sono supportati dell'oggetto recordset, chiamare CanBookmark. Per rendere disponibile se sono supportati i segnalibri, è necessario impostare l'opzione CRecordset:: useBookmarks nel parametro dwOptions della funzione membro Open.
&Notanbsp; Se i segnalibri sono non supportato o non disponibile, chiamata SetBookmark genererà un'eccezione. I segnalibri non supportati sui recordset forward-only.
Per recuperare prima del segnalibro per il record corrente, chiamare GetBookmark, che salva il valore segnalibro a un oggetto CDBVariant . Più tardi, può tornare quel record chiamando SetBookmark utilizzando il valore di segnalibro salvato.
&Notanbsp; Dopo alcune operazioni di recordset, è necessario verificare la persistenza di segnalibro prima di chiamare SetBookmark. Ad esempio, se recuperare un segnalibro con GetBookmark e quindi chiamare Requery, il segnalibro non può più essere valido. Chiamare CDatabase:: GetBookmarkPersistence per verificare se è possibile chiamare con sicurezza SetBookmark.
Per ulteriori informazioni su segnalibri e navigazione recordset, vedere gli articoli Recordset: i segnalibri e le posizioni assolute (ODBC) e Recordset: Scrolling (ODBC) nel manuale del programmatore di Visual C++.
Pa&noramica CRecordset |nbsp; Membri della classe | Gerarchia Chart
Vedere a&nchenbsp;CRecordset:: CanBookmark, CRecordset::GetBookmark, CRecordset:: SetAbsolutePosition, CDatabase:: GetBookmarkPersistence