CDaoRecordset::Delete

Article
03/04/2013

Appelez la fonction membre pour supprimer l'enregistrement actif dans un objet ouvert de type feuille de réponse dynamique ou de recordset de type table.

virtual void Delete( );

Notes

Après une suppression a réussi, les membres de données de type champ de recordset sont définies à une valeur NULL, et vous devez appeler explicitement une des fonctions membres de navigation de recordset (Déplacement, accès, SetBookmark, etc.) pour fermer l'enregistrement supprimé.Lorsque vous supprimez des enregistrements dans un recordset, il doit exister un enregistrement actif dans le recordset avant d'appeler Supprimer; sinon, MFC lève une exception.

Supprimer supprime l'enregistrement actif et le rend inaccessible.Bien que vous ne puissiez pas modifier ou utiliser l'enregistrement supprimé, il reste actif.Une fois que vous accédez à un autre enregistrement, toutefois, vous ne pouvez pas passer la valeur actuelle d'enregistrement supprimé de nouveau.

Attention
Le recordset doit être modifiable et il doit exister un actuel d'enregistrement valide dans le recordset lorsque vous appelez Supprimer.Par exemple, si vous supprimez un enregistrement mais ne le faites pas par défilement à un nouvel enregistrement avant d'appeler Supprimer de nouveau, Supprimer lève CDaoException.

Vous pouvez redémarrer un enregistrement si vous utilisez des transactions et vous appelez la fonction membre de CDaoWorkspace::Rollback .Si la table de base est la table primaire d'une relation de suppression en cascade, effacer l'enregistrement en cours peut également supprimer un ou plusieurs enregistrements dans une table source qui contient une clé étrangère.Pour plus d'informations, consultez la définition « delete en cascade » dans l'aide de DAO.

Contrairement à AddNew et de Modifier, un appel à Supprimer n'est pas suivie par un appel à Mettre à jour.

Pour des informations connexes, consultez les rubriques traitant méthode d'AddNew », « la méthode de modification », « méthode de suppression », « méthode update », et « propriété pouvant être mis à jour » dans l'aide de DAO.