Função: TCDelFile
Exclui um arquivo do banco de dados relacional, através do DBAccess.
TCDelFile ( < cTabela> ) --> lOk
Nome | Tipo | Descrição | Obrigatório | Referência |
cTabela | Caracter | Indica 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