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 assinada que especifica o número de registros que a posição do registro atual move.

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

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 para a posição antes do primeiro registro no conjunto de registros (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 no conjunto de registros (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 o argumento Iniciar , a movimentação será relativa ao registro com este indicador, supondo que o objeto Recordset dê suporte a indicadores. 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.

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 Mover 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 sobre 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 anteriores dessa maneira, chamar o método MovePrevious em qualquer objeto Recordset somente para frente ainda gerará um erro.

Aplica-se a

do 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)
do Método MoveRecord (ADO)