Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Pagetitle
TCSqlExecTCSQLExecTCSqlExec
TCSQLExec

Executa uma sentença instrução de sintaxe SQL (Structured Query Language) diretamente no banco de dados em que está conectado.

Sintaxe

Bloco de código
collapsefalse
TCSqlExecTCSQLExec( < cStatement > )

Parâmetros

Nome

Tipo

Descrição

Obrigatório

Referência

cStatement

caractere

Indica a

string que contém a sentença

instrução que será

informada à função e

executada no banco de dados.

X


Retorno

Nome

Tipo

Descrição

nStatus

numérico

Retorna o status da execução. Se menor que 0 indica que a

sentença

instrução não foi executada com sucesso.

Observações

...

  • O parâmetro cStatement é extremamente dependente do SGBD (Sistema Gerenciador de Banco de Dados) e deve ser construída visando o banco de dados utilizado.
  • É aconselhável que o parâmetro

...

  • cStatement execute uma única instrução por vez. Isto porque a solicitação de execução de mais de uma instrução no Statement está sujeito ao comportamento do

...

  • SGBD.
  • Essa função, por submeter instruções SQL diretamente ao SGBD, podendo utilizar tabelas não criadas pelo
    Inclusão de trecho
    DBAccess
    DBAccess
    nopaneltrue
    , não atualiza os campos de controle criados pelo
    Inclusão de trecho
    DBAccess
    DBAccess
    nopaneltrue
    .

Exemplos

Bloco de código
languagecpp
themeEclipse
linenumberstrue
collapsefalse
USER FUNCTION TEST()
  TCLink()
  
  TCDelFile("T1")
  
  DBCreate("T1", {{"FIELD_NAME", "C", 10, 0}, ;
                  {"FIELD_TYPE", "C", 10, 0}}, "TOPCONN")
                  
  nStatus := TCSqlExec("insert into t1 (field_name, field_type) values ('name', 'type')")
  
  if (nStatus < 0)
    conout("TCSQLError() " + TCSQLError())
  endif
  
  TCUnlink()
RETURN

...