Propriedade Bookmark (ADO)

Indica um indicador que identifica exclusivamente o registro atual em um objeto Recordset ou define o registro atual em um objeto Recordset como o registro identificado por um indicador válido.

Configurações e valores retornados

Define ou retorna uma expressão Variant que é avaliada como um indicador válido.

Comentários

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

Quando você abre um objeto Recordset, cada um de seus 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 a esse registro a qualquer momento depois de mover para um registro diferente, defina a propriedade Bookmark do objeto Recordset como o valor dessa variável.

O usuário pode não conseguir exibir o valor do indicador. Além disso, os usuários não devem esperar que os indicadores sejam diretamente comparáveis, pois dois indicadores que se referem ao mesmo registro podem ter valores diferentes.

Se você usar o método Clone para criar uma cópia de um objeto Recordset, as configurações da propriedade Bookmark para os objetos Recordset originais e duplicados serão idênticas e você poderá usá-los de forma intercambiável. No entanto, você não pode usar indicadores de diferentes objetos Recordset de maneira intercambiável, mesmo que eles tenham sido criados com base na mesma origem ou comando.

Observação

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

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo das propriedades BOF, EOF e Bookmark (VB)
Exemplo das propriedades BOF, EOF e Bookmark (VC++)
Método Supports