Compartilhar via


Ir para um registro

O método Move permite mover para frente ou para trás no conjunto de registros um número especificado de registros usando a seguinte sintaxe:

oRs.Move NumRecords, Start  

Observações

O método Move é suportado em todos os objetos Recordset.

Se o argumento NumRecords for maior que zero, a posição atual do registro avançará (em direção ao fim do Recordset). Se NumRecords for menor que zero, a posição atual do registro se moverá para trás (em direção ao início do Recordset).

Se a chamada Mover mover a posição do registro atual para um ponto antes do primeiro registro, o ADO definirá o registro atual na posição anterior ao primeiro registro no Recordset (BOF é True). Uma tentativa de retroceder quando a propriedade BOF já estiver True gera um erro.

Se a chamada Mover mover a posição atual do registro para um ponto após o último registro, o ADO definirá o registro atual para a posição após o último registro na Recordset ( EOF é True). Uma tentativa de avançar quando a propriedade EOF já estiver True gera um erro.

Chamar o método Move de um objeto Recordset vazio gera um erro.

Se você passar um indicador no argumento Iniciar, a movimentação será relativa ao registro com este indicador, supondo que o objeto Recordset dê suporte a indicadores. Um marcador é obtido usando a propriedade Bookmark. Se não for especificado, a movimentação será relativa ao registro atual.

Se você estiver usando a propriedade CacheSize para armazenar registros em cache localmente do provedor, passar um NumRecords argumento que move a posição atual do registro fora do grupo atual de registros armazenados em cache força o ADO a recuperar um novo grupo de registros, começando pelo registro de destino. A propriedade CacheSize determina o tamanho do grupo recém-recuperado e o registro de destino é o primeiro registro recuperado.