...
Ela possui todos os métodos da FWPreparedStatement (FWPreparedStatement) e utiliza os conceitos do cache de queries(FWExecCachedQuery)
É utilizada para fazer cache ou não das queries executadas e realiza o bind de queries diretamente no banco de dados, o que torna o plano de execução das queries melhor aproveitado, gerando ganho de performance.
...
Descrição:
Executa a query scalar (que retorna uma coluna) e retorna seu valor. Ela tem o mesmo comportamento da função MPSysExecScalar
Parâmetros:
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
cColumn | Caracter | Nome da coluna a ser retornada da query | Sim. |
cLifetime | Caracter | Define se a query vai ficar no cache da dbapi e qual o tempo de vida dela. | Não. Mas caso o parâmetro cTimeout seja enviado sim |
cTimeOut | Caracter | Define se a query vai ficar no cache da dbapi e qual o tempo de timeout dela | Não. Mas caso o parâmetro cLifetime seja enviado, sim |
Retorno:
xValue
Exemplo de Uso da Classe
Bloco de código |
---|
#include 'protheus.ch'
user Function myExec()
Local cQuery as character
Local cAlias as character
local oExec as object
cQuery := "SELECT ? FROM SE1T10 WHERE E1_FABOV = ? AND D_E_L_E_T_ = ?"
cQuery := ChangeQuery(cQuery)
oExec := FwExecStatement():New(cQuery)
oExec:SetUnsafe(1,'E1_NUM')
oExec:SetNumeric(2,0)
oExec:SetString(3,' ')
cAlias := oExec:OpenAlias()
//Também existe o método ExecScalar para esta classe, que se comporta bem parecido com a
//função FwExecScalar
//cQuery := "SELECT COUNT(*) CNT FROM SE1T10 WHERE E1_FABOV = ? AND D_E_L_E_T_ = ?"
//...........................
//oExec:ExecScalar('CNT')
(cAlias)→(DbCloseArea())
oExec:Destroy()
oExec := nil
Return
|