Reading time: 1 minute
A função GetArea é utilizada para proteger o ambiente ativo no momento de algum processamento específico para salvar uma outra área de trabalho(alias) que não o ativo. Essa função deve ser executada dentro do alias: ALIAS->(GetArea()). Esse ambiente protegido é restaurado utilizando a função RestArea. Ela é uma das Funções de Acesso a Banco de Dados / SQL no Protheus em ADVPL.
Sintaxe:
GetArea()
Parâmetro(s):
Nenhum.
Retorno(s):
Exemplo da função GetArea em ADVPL:
Suponhamos que o ambiente ativo seja do alias SA2(Alias()), índice 1(IndexOrd())e registro 320(Recno()):
#include 'protheus.ch'
#INCLUDE "TBICONN.CH"
/*{Protheus.doc} User Function PAGetAre
(Essa função tem por finalidade mostrar a Funções de Acesso a Banco de Dados / SQL no Protheus GetArea em ADVPL)
@type Function
@author Adilio Costa
@since 05/12/2023
@version 1.0
@Inscreva-se no Blog ProtheusAdvpl:
https://www.protheusadvpl.com.br
@Inscreva-se no Canal ProtheusAdvpl:
https://www.youtube.com/protheusadvpl
@Siga-nos no Instagram:
https://www.instagram.com/protheusadvpl
@Conheça os Cursos do ProtheusAdvpl:
https://hotmart.com/pt-br/club/protheusadvpl
|Se esse conteúdo foi útil pra você nos ajude divulgando
ele e nossas redes sociais!!|
*/
User Function PAGetAre()
/*
A variável aArea conterá os dados:
aArea[1]:O alias SA2(Alias()), aArea[2]:O Índice 1(IndexOrd()) e aArea[3]:O registro 320(Recno())*/
Local aArea := GetArea() //Salvando a área atual
//Definindo a tabela SA1(Clientes) como à área de trabalho ativa
DBSelectArea("SA1")
SA1->(DBSetOrder(1))
//Restaurando o ambiente salvo(Ambiente de SA2)
RestArea(aArea)
Return
É isso aí, finalizamos aqui mais um post no Blog ProtheusAdvpl. Caso tenha ficado alguma dúvida deixe seu comentário ou nos envie um e-mail para adiliocosta@protheusadvpl.com.br, até um próximo post, grande abraço e fica com Deus.
Link(s) de referência(s):
