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
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)