Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Move para o primeiro, o último, o próximo ou o registro anterior em um objeto Recordset especificado e torna esse registro o registro atual.
Sintaxe
recordset.{MoveFirst | MoveLast | MoveNext | MovePrevious}
Observações
Use o método MoveFirst para mover a posição atual do registro para o primeiro registro no Recordset.
Use o método MoveLast para mover a posição do registro atual para o último registro no Recordset. O objeto Recordset deve dar suporte a indicadores ou movimento de cursor para trás; caso contrário, a chamada de método gerará um erro.
Uma chamada para MoveFirst ou MoveLast quando o do conjunto de registros estiver vazio ( BOF e EOF são True) gera um erro.
Use o método MoveNext para mover a posição atual do registro um registro para frente (em direção à parte inferior do conjunto de registros ). Se o último registro for o registro atual e você chamar o método MoveNext, 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á estiver True gerar um erro.
No ADO 2.5 e posterior, quando o Recordset foi filtrado ou classificado e os dados do registro atual são alterados, chamar o método MoveNext move o cursor dois registros para frente do registro atual. Isso ocorre porque quando o registro atual é alterado, o próximo registro se torna o novo registro atual. Chamar MoveNext após a alteração move o cursor um registro para frente do novo registro atual. Isso é diferente do comportamento no ADO 2.1 e anterior. Nessas versões anteriores, alterar os dados de um registro atual no do Recordset classificado ou filtrado não altera a posição do registro atual e MoveNext move o cursor para o próximo registro imediatamente após o registro atual.
Use o método MovePrevious para mover a posição atual do registro um registro para trás (em direção à parte superior da Recordset). O objeto Recordset deve dar suporte a indicadores ou movimento de cursor para trás; caso contrário, a chamada de método gerará um erro. Se o primeiro registro for o registro atual e você chamar o método MovePrevious, o ADO definirá o registro atual para a posição antes do primeiro registro no Recordset ( BOF é True). Uma tentativa de se mover para trás quando a propriedade BOF já estiver True gerar um erro. Se o recordset objeto não oferecer suporte a indicadores ou movimento de cursor para trás, o método MovePrevious gerará um erro.
Se o conjunto de registros for somente para frente e você quiser dar suporte à rolagem para frente e para trás, você poderá usar a propriedade CacheSize para criar um cache de registro que dará suporte à movimentação de cursor para trás por meio do método Move. 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. Você pode chamar o método MoveFirst em um objeto Recordset somente para encaminhamento; Isso pode fazer com que o provedor execute novamente o comando que gerou o recordset objeto.
Aplica-se a
do objeto Recordset (ADO)
Consulte Também
exemplo dos métodos MoveFirst, MoveLast, MoveNext e MovePrevious (VB)
exemplo dos métodos MoveFirst, MoveLast, MoveNext e MovePrevious (VBScript)
exemplo dos métodos MoveFirst, MoveLast, MoveNext e MovePrevious (VC++)
do Método Move (ADO)
métodos MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)
do Método MoveRecord (ADO)