Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Migration of unmigrated content due to installation of a new plugin
Composition Setup
import.css=/download/attachments/327912/newLayout.css
Portuguese

Pagetitle
TCDelFile
TCDelFile

Função: TCDelFile

Exclui um arquivo do banco de dados relacional, através do DBAccess.

TCDelFile ( < cTabela> ) --> lOk

NomeTipoDescriçãoObrigatórioReferência
cTabelaCaracterIndica o nome da tabela que será excluída. X
    lOk(logico)
  • Retorna verdadeiro (.T.), se a tabela for excluída com sucesso; caso contrário, falso (.F.). Geralmente, o retorno falso (.F.), ocorre quando a tabela está sendo utilizada por outro processo ou a tabela não existe no banco de dados.

Ao apagar uma tabela utilizando TCDelFile(), a tabela é excluída fisicamente do banco de dados, internamente através de uma instrução "DROP TABLE". Adicionalmente, a exclusão da tabela através desta função, limpa o cache de definição desta tabela da lista de estruturas em memória do DBAccess, elimina as definições complementares da tabela TOP_FIELD relacionadas à tabela que está sendo excluída, e não permite que esta operação seja feita caso exista alguma conexão com essa tabela aberta para acesso a dados no ERP.

Esta verificação não é capaz de determinar se a tabela ou parte de seu conteúdo está sendo acessado por outro processo mediante uma query, por exemplo. Neste caso, a instrução para destruir a tabela será executada, e o resultado da mesma depende do comportamento do banco de dados.

cTabela := "TMPR010"If TcCanOpen(cTabela)  lOk := TcDelFile(cTabela)  If lOk    MsgInfo("Tabela "+cTabela+" apagada.")  Else    MsgStop("Falha ao apagar "+cTabela+" : "+ TcSqlError())  EndifElse  MsgInfo("Talbela "+cTabela+" nao encontrada.")Endif
Advanced Protheus 6.09 , Advanced Protheus 7.10 , Microsiga Protheus 8.11 , Protheus 10 , TOTVS Application Server 10 , ByYou Application Server