Propriedade Bookmark (ADO)

Aplica-se ao: Access 2013, Office 2013

Aponta um indicador que identifica com exclusividade o registro atual em um objeto Recordset ou define o registro atual em um objeto Recordset para o registro identificado por um indicador válido.

Configurações e valores retornados

Configura ou retorna uma expressão Variant que avalia um indicador válido.

Comentários

Use a propriedade Bookmark para salvar a posição do registro atual e retornar para esse registro a qualquer momento. Bookmarks estão disponíveis apenas em objetos Recordset que ofereçam suporte à funcionalidade de indicadores.

Quando um objeto Recordset é aberto, cada um dos registros tem um indicador exclusivo. Para salvar o indicador do registro atual, atribua o valor da propriedade Bookmark a uma variável. Para retornar rapidamente àquele registro depois de se mover para um registro diferente, defina a propriedade Bookmark do objeto Recordset com o valor daquela variável.

Talvez o usuário não seja capaz de exibir o valor do indicador. Além disso, os usuários não devem esperar que os indicadores sejam comparados diretamente — dois indicadores referentes ao mesmo registro podem ter valores diferentes.

Se você usar o método Clone para criar uma cópia de um objeto Recordset, as definições da propriedade Bookmark para os objetos Recordset original e duplicado serão idênticas e você poderá usá-las alternadamente. Contudo, não é possível usar indicadores de objetos Recordset diferentes alternadamente, mesmo que eles tenham sido criados a partir da mesma fonte ou comando.

Uso do Serviço de Dados RemotoQuando usada em um objeto Recordset do lado do cliente, a propriedade Bookmark está sempre disponível.