CRecordset::SetBookmark
Posiciona o conjunto de registros no registro que contém o indexador especificado.
void SetBookmark(
const CDBVariant& varBookmark
);
Parâmetros
- varBookmark
Uma referência a um objeto de CDBVariant que contém o valor do indexador de um registro específico.
Comentários
Para determinar se os indicadores são suportados no conjunto de registros, CanBookmarkchamada.Para tornar disponíveis se indicadores são suportados, você deve definir a opção de CRecordset::useBookmarks no parâmetro de dwOptions da função de membro de Abrir .
.gif "Observação") Observação |
|---|
Se os indicadores são sem suporte ou indisponível, chame SetBookmark resultará em uma exceção que está sendo lançada.Indexadores não são suportados em conjuntos de registros somente encaminhamentos. |
O primeiro recuperar o indicador para o registro atual, a chamada GetBookmark, que salva o valor do indexador a um objeto de CDBVariant .Posteriormente, você pode retornar ao registro chamando SetBookmark usando o valor salvo do indexador.
| Observação |
|---|
Após certas operações de conjunto de registros, você deve verificar a persistência do indexador antes de chamar SetBookmark.Por exemplo, se você recupera um indexador com GetBookmark e então chama Requery, o indexador pode não ser válido.Chame CDatabase::GetBookmarkPersistence para verificar se você possa chamar com segurança SetBookmark. |
Para obter mais informações sobre configuração e navegação do conjunto de registros, consulte os artigos conjunto de registros: Indexadores e posições absolutas (ODBC) e conjunto de registros: Imprima (ODBC).
Exceções
Esse método pode lançar exceções do tipo CDBException* e CMemoryException*.
Requisitos
Cabeçalho: afxdb.h