Descrição
TCDelFile [AS] - Exclui um arquivo do banco de dados relacional, através do DBAccess
|
Sintaxe
Parâmetros
| Par |
Nome |
Tipo |
Descrição |
Default |
Obg |
Ref |
01
|
cTabela
|
Caracter
|
Indica o nome da tabela que será excluída
|
|
X |
|
Retorno
| Retorno |
Tipo |
Descrição |
| lRet |
Boolean
|
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.
|
Exemplo
#INCLUDE "TOTVS.CH"
User Function TCDelFile()
If TCDelFile( RetSQLName('TCC') )
MsgInfo( 'Deletado', 'UniversoADVPL' )
Else
MsgInfo( 'Erro', 'UniversoADVPL' )
Endif
Return( Nil
Resultado
Informações adicionais
|
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
|
Gostou? Compartilhe com seus amigos e deixe um comentário! 😎
