Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

DBCloseArea

DBCloseArea() --> Nil

Fecha a área de trabalho e libera seus recursos.

DBCloseAreaAdvPL
01 · VISÃO GERAL

Visão geral

DBCloseArea atua no alias corrente do contexto da chamada. A documentação descreve efetivação de atualizações pendentes e liberação de locks e recursos. Fechar uma área não apaga o arquivo e não desfaz alterações. O exemplo qualifica a chamada pelo alias próprio, evitando fechar uma área arbitrária do chamador; não deve fechar um alias emprestado pelo framework. 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)

02 · SINTAXE

Sintaxe

DBCloseArea() --> Nil

Retorno

Nil; não é um indicador lógico de sucesso.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed325()
    // EDTRB deve pertencer a esta rotina, sem uso posterior.
    If Select("EDTRB") > 0
        EDTRB->(DBCloseArea())
    EndIf
Return Nil
Resultado esperado

Alias de teste fechado, sem remoção do arquivo físico. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • 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.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DBCloseArea. TDN. Consulta em 2026-10-26.
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