Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Composition Setup
import.css=/download/attachments/3279126062824/newLayouttecnologia.css

Pagetitle
DBSetDriver
DBSetDriver

Função: DBSetDriver

Define qual RDD - Replaceable Database Driver será definida como padrão ou verifica qual está definida, caso o parâmetro <cNovoRDD> não seja especificado.

 

DBSetDriver ( [ cNovoRDD] ) --> cRet

Retorna a RDD padrão que é utilizada, podendo alterá-la.

Sintaxe

Bloco de código
collapsefalse
DBSetDriver( [ cRDD ] )

Parâmetros

...

Nome

Tipo

Descrição

Obrigatório

Referência

...

cRDD

...

caractere

Indica

...

a nova RDD padrão.

 

 

 

...

Retorno

Nome

Tipo

Descrição

cRet

caractere

...

//Este exemplo, apresenta como utilizar a função DBSetDriver() para alterar o valor do RDD padrão.
DBSetDriver("CTREECDX") // Retorna: DBFCDX
DBSetDriver() // Retorna: CTREECDX
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server

Retorna o nome da RDD padrão.

Observações

  • Os valores válidos para cRDD são:
    • DBFCDX
    • DBFCDXTTS
    • DBFCDXAX
    • BTV
    • BTVCDX
    • CTREECDX
    • TOPCONN
    • CODEBCDX
    • CODEBCDXTTS
    • DBFCDXADS
    • MEMORY
    • SQLITE
    • CTREETMP
  • Se o valor de cRDD não for válido, a RDD padrão não será alterada e irá retornar o valor da RDD padrão atual.
  • Caso cRDD seja uma string vazia ou nulo (Nil), a função não irá alterar a RDD padrão e irá retornar o valor da RDD padrão atual.
  • Quando a RDD padrão é alterada, a função retorna o valor do valor da RDD padrão anterior.
  • O valor padrão é DBFCDX.
  • Não é necessário ter uma área de trabalho aberta ou conexão com um SGBD para essa função funcionar adequadamente.
  • Essa função tem o mesmo comportamento da função RDDSetDefault.

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
user function test1()
  // Exibe a RDD padrão (DBFCDX).
  conout( DBSetDriver() )

  // Exibe a RDD padrão, pois o parâmetro é inválido.
  conout( DBSetDriver( "NOTEXISTS" ) )
  
  // Altera a RDD padrão para "TOPCONN" e exibe o valor anterior (DBFCDX).
  conout( DBSetDriver( "TOPCONN" ) )
return

Veja também

 

...