Método Move (ADO)

Move a posição do registro atual em um objeto Recordset.

Sintaxe

  
recordset.Move NumRecords, Start  

Parâmetros

NumRecords
Uma expressão Long com sinal que especifica o número de registros pelo qual a posição do registro atual move.

Iniciar
Opcional. Um valor String ou Variant que é avaliado como um indicador. Você também pode usar um valor BookmarkEnum.

Comentários

Há suporte para o método Move em todos os objetos Recordset.

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

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

Se a chamada Move 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 no Recordset (EOF é True). Uma tentativa de avançar quando a propriedade EOF já é True gera um erro.

A chamada ao método Move de um objeto Recordset vazio gera um erro.

Se você transmitir o argumento Start, a movimentação será relativa ao registro com esse indicador, supondo que o objeto Recordset dê suporte a indicadores. Se isso não for especificado, a movimentação será relativa ao registro atual.

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

Se o objeto Recordset for somente para frente, um usuário ainda poderá passar um argumento NumRecords menor que zero, desde que o destino esteja dentro do conjunto atual de registros armazenados em cache. Se a chamada Move mover a posição do registro atual para um registro antes do primeiro registro armazenado em cache, ocorrerá um erro. Assim, você pode usar um cache de registro que dá suporte à rolagem completa em vez de um provedor que dá suporte apenas à rolagem para frente. Como os registros armazenados em cache são carregados na memória, você deve evitar armazenar mais registros em cache do que o necessário. Mesmo que um objeto Recordset somente para frente dê suporte a movimentos para trás dessa forma, chamar o método MovePrevious em qualquer objeto Recordset somente para frente ainda gerará um erro.

Observação

O suporte à movimentação para trás em um Recordset somente para frente não é previsível, dependendo do provedor. Se o registro atual tiver sido posicionado após o último registro no Recordset, Move para trás pode não resultar na posição atual correta.

Aplica-se A

Objeto Recordset (ADO)

Consulte Também

Exemplo do método Move (VB)
Exemplo do método Move (VBScript)
Exemplo do método Move (VC++)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)
Método MoveRecord (ADO)