Histórico da Página
Incluir Página | ||||
---|---|---|---|---|
|
Sintaxe
DbSkip(<expressão numérica>)
Propósito
Move o cursor do registro posicionado para o próximo registro (ou anterior, dependendo do argumento), de acordo com o índice ativo para a área de trabalho.
Argumentos
<expressão caracter>
É a quantidade de registros que devem ser percorridos. Ou seja, define em quantos registros o cursor será deslocado.
Caso o usuário não informe esse argumento, o padrão utilizado será 1. Ou seja, se avançará um registro.
Dicas
Em ambientes com bancos de dados relacionais (SQL, Oracle, etc.) deve-se evitar a utilização da função para movimentar o cursor nos registros anteriores, expressa pela sintaxe dbSkip(-1), pois essa ação pode gerar lentidão no processamento.
Exemplos
Neste exemplo, mostraremos o avanço de registros.
dbSelectArea(“SA1”)
dbSetOrder(2) // A1_FILIAL + A1_NOME
dbGoTop() // Posiciona o cursor no início da área de trabalho ativa
WHILE !EOF() // Executa enquanto o cursor da área de trabalho ativa não indicar fim de arquivo
MsgInfo(“Você está no cliente: “ + A1_NOME)
dbSkip()
ENDDO
Neste exemplo mostraremos o retrocesso dos registros.
dbSelectArea(“SA1”)
dbSetOrder(2) // A1_FILIAL + A1_NOME
dbGoBotton() // Posiciona o cursor no final da área de trabalho ativa
WHILE !BOF() // Executa enquanto o cursor da área de trabalho ativa não indicar início de arquivo
MsgInfo(“Você está no cliente: “ + A1_NOME)
dbSkip(-1)
ENDDO