nPosNuméricoObrigatório
Número físico válido obtido por RecNo.
FUNçãOEm revisão
DBGoTo
DBGoTo( nPos ) --> NilPosiciona pelo número físico do registro.
Visão geral
DBGoTo recebe um RecNo físico válido para a tabela, não uma linha visual nem a posição na ordem do índice. A navegação física pode alcançar um registro fora do filtro; não usar como controle de autorização. O exemplo guarda a posição existente, vai ao início lógico e volta ao mesmo número; não pressupõe que o número 1 seja um registro válido. A referência DBSetFilter documenta a diferença entre navegação lógica e DBGoTo. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)
Sintaxe
DBGoTo( nPos ) --> NilParâmetros
Retorno
Nil; não é um indicador lógico de sucesso.
Exemplo comentado
#Include "Protheus.ch"
User Function Ed333()
Local nRegistro
If Select("EDTRB") > 0
If !EDTRB->(Eof())
nRegistro := EDTRB->(RecNo())
EDTRB->(DBGoTop())
EDTRB->(DBGoTo(nRegistro))
ConOut(cValToChar(EDTRB->(RecNo()) == nRegistro))
EndIf
EndIf
Return NilResultado esperado
Verdadeiro se o registro continuar válido durante o fragmento; nenhuma garantia contra alterações concorrentes. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
- Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
- Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.
Comentários
Ainda não há comentários aprovados.
Entre com Google ou Microsoft para comentar.