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.

Aviso

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 CDaoRecordset

Gráfico da hierarquia

CDaoRecordset::AddNew

CDaoRecordset::CancelUpdate

CDaoRecordset::Edit

CDaoRecordset::Update

CDaoRecordset::CanTransact