Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (ADO)
Move-se 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}
Comentários
Use o método MoveFirst para mover a posição do registro atual 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 precisa permitir indicadores ou o movimento de retrocesso do cursor. Caso contrário, a chamada do método gerará um erro.
Uma chamada para MoveFirst ou MoveLast quando Recordset está vazio (tanto BOF quanto EOF são True) gera um erro.
Use o método MoveNext para mover a posição atual do registro adiante um registro (em direção ao final do Recordset). Se o último registro for o registro atual e você chamar o método MoveNext, o ADO definirá o registro atual como 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.
No ADO 2.5 e posterior, quando o Recordset foi filtrado ou classificado e os dados do registro atual são alterados, o chamamento do método MoveNext move o cursor dois registros adiante do registro atual. Isso ocorre porque quando o registro atual é alterado, o próximo registro se torna o novo registro atual. O chamamento de MoveNext após a alteração move o cursor um registro adiante do novo registro atual. Isso é diferente do comportamento no ADO 2.1 e em versões anteriores. Nessas versões anteriores, a alteração dos dados de um registro atual no 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 ao início do Recordset). O objeto Recordset precisa permitir indicadores ou o movimento de retrocesso do cursor. Caso contrário, a chamada do 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 como 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 o objeto Recordset não der suporte a indicadores ou movimento de cursor para trás, o método MovePrevious gerará um erro.
Se o Recordset for somente para frente e você quiser dar suporte à rolagem para frente e para trás, poderá usar a propriedade CacheSize para criar um cache de registro que dará suporte à movimentação do 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 objeto Recordset.
Aplica-se A
Consulte Também
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (VB)
Exemplo dos métodos MoveFirst, MoveLast, MoveNext e MovePrevious (VBScript)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (VC++)
Método Move (ADO)
Métodos MoveFirst, MoveLast, MoveNext e MovePrevious (RDS)
Método MoveRecord (ADO)