Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

DBDelete

DBDelete()

Marca o registro atual para exclusão lógica.

DBDeleteAdvPL
01 · VISÃO GERAL

Visão geral

DBDelete marca o registro corrente; não equivale a remover fisicamente todos os registros. A referência TOPCONN descreve o controle R_E_C_D_E_L_; o tratamento deve permanecer na API apropriada em vez de alterar colunas de controle manualmente. O fragmento atua somente após obter RecLock no registro da tabela própria. Não transfira essa operação para tabelas de negócio sem a rotina e as validações do módulo. EDTRB identifica exclusivamente uma tabela própria de teste, já aberta com a estrutura e os direitos necessários; os exemplos não se destinam a tabelas padrão. (TOTVS, s.d., ref. 1)

02 · SINTAXE

Sintaxe

DBDelete()

Retorno

Retorno não formalizado na ficha consultada; não usado no exemplo.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed330()
    // EDTRB e descartavel; registro de teste previamente localizado.
    If Select("EDTRB") > 0
        If !EDTRB->(Eof())
            If RecLock("EDTRB", .F.)
                EDTRB->(DBDelete())
                EDTRB->(MsUnlock())
            EndIf
        EndIf
    EndIf
Return Nil
Resultado esperado

Com lock obtido, solicita exclusão lógica do registro de teste; tratamento completo de erro não está implementado. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir RDD, alias e operações pendentes. Navegação pode efetivar atualizações; preservar contexto conforme o contrato do chamador e tratar erros na rotina completa.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. TOTVS. DBDelete. TDN. Consulta em 2026-10-26.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha