Usina BRAdvPL Guia
Entrar
← Todos os tópicos
GUIA PRÁTICOEm revisão

Manipulação de áreas de trabalho e aliases

GetArea() -> aArea; RestArea(aArea)

Preserva posição e ordem ao consultar áreas abertas.

Manipulação de áreas de trabalho e aliasesAdvPL
01 · VISÃO GERAL

Visão geral

GetArea captura alias, ordem e registro da área corrente; RestArea restaura esse contexto. Não é rollback de dados, filtros ou transações. Ao trabalhar em outra área, salve também o contexto dela com execução no alias. Um alias identifica a área aberta nesta execução e não deve ser confundido com o nome físico da tabela. Fechar uma área antes da restauração invalida a suposição de que ainda exista. (Fontes: refs. 1–2.)

02 · SINTAXE

Sintaxe

GetArea() -> aArea; RestArea(aArea)
03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed520()
    Local aArea := GetArea()
    // Nao altera dados nem fecha o alias salvo.
    ConOut(ValType(aArea))
    RestArea(aArea)
Return Nil
Resultado esperado

Imprime A e restaura o contexto capturado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Restaurar também nos caminhos de erro. Fechar somente aliases abertos pela própria rotina e manter clara a propriedade de cada recurso.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. GetArea. TDN. Consulta em 2026-10-27.
  2. TOTVS. RestArea. TDN. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha