Compartilhar via


CDaoRecordset::Delete

Chamar essa função de membro para excluir o registro atual em um objeto de abertura do conjunto de registros de dynaset- tipo ou tabela de tipo.

virtual void Delete( );

Comentários

Depois de uma exclusão com êxito, os membros de dados do campo do conjunto de registros são definidos como um valor nulo, e você deve explicitamente chamar uma das funções de membro de navegação do conjunto de registros (Mover, Pesquisa, SetBookmark, e assim por diante) para mover fora do registro excluído.Quando você excluir registros de um conjunto de registros, deve haver um registro atual no conjunto de registros antes de chamar Excluir; caso contrário, o MFC gera uma exceção.

Excluir remove o registro atual e o torna inacessível.Embora você não possa editar ou usar o registro excluído, permanece atual.Uma vez que você move para outro registro, no entanto, você não pode fazer a atual excluída do registro novamente.

Observação de cuidadoCuidado

O conjunto de registros deve ser atualizável e deve haver uma corrente válido no registro do conjunto de registros quando você chama Excluir.Por exemplo, se você excluir um registro mas não o colocar um novo registro antes de chamar Excluir novamente, Excluir gera CDaoException.

Você pode restaurar um registro se você usar transações e você chama a função de membro de CDaoWorkspace::Rollback .Se a tabela de base é a tabela principal em um relacionamento em cascata delete, excluir o registro atual também pode excluir um ou mais registros na tabela externa.Para obter mais informações, consulte a definição de cascata “excluir” na ajuda de DAO.

A o contrário de AddNew e de Editar, uma chamada a Excluir não é seguido por uma chamada a Atualizar.

Para informações relacionadas, consulte os tópicos de “método AddNew”, “método edição”, “método excluir”, “método update”, “propriedade e atualizável” na ajuda de DAO.

Requisitos

Cabeçalho: afxdao.h

Consulte também

Referência

Classe de CDaoRecordset

Gráfico de hierarquia

CDaoRecordset::AddNew

CDaoRecordset::CancelUpdate

CDaoRecordset::Edit

CDaoRecordset::Update

CDaoRecordset::CanTransact