Delete, méthode (objet Recordset ADO)

Supprime l’enregistrement actif ou un groupe d’enregistrements.

Syntaxe

  
recordset.Delete AffectRecords  

Paramètres

AffectRecords
Une valeur AffectEnum qui détermine le nombre d’enregistrements affectés par la méthode Delete. La valeur par défaut est adAffectCurrent.

Notes

adAffectAll et adAffectAllChapters ne sont pas des arguments valides pour Delete.

Notes

L’utilisation de la méthode Delete marque l’enregistrement actif ou un groupe d’enregistrements dans un objet Recordset pour suppression. Si l’objet Recordset n’autorise pas la suppression des enregistrements, une erreur se produit. Si vous êtes en mode mise à jour immédiate, les suppressions se produisent immédiatement dans la base de données. Si un enregistrement ne peut pas être supprimé avec succès (en raison de violations de l’intégrité de la base de données, par exemple), l’enregistrement reste en mode édition après l’appel à Update. Cela signifie que vous devez annuler la mise à jour avec CancelUpdate avant de quitter l’enregistrement actif (par exemple, avec Close, Move ou NextRecordset).

Si vous êtes en mode de mise à jour par lot, les enregistrements sont marqués pour suppression du cache, et la suppression réelle se produit lorsque vous appelez la méthode UpdateBatch. Utilisez la propriété Filter pour afficher les enregistrements supprimés.

La récupération des valeurs de champ à partir de l’enregistrement supprimé génère une erreur. Après avoir supprimé l’enregistrement actif, l’enregistrement supprimé reste actif jusqu’à ce que vous accédiez à un autre enregistrement. Une fois que vous quittez l’enregistrement supprimé, il n’est plus accessible.

Si vous imbriquez des suppressions dans une transaction, vous pouvez récupérer des enregistrements supprimés avec la méthode RollbackTrans. Si vous êtes en mode de mise à jour par lots, vous pouvez annuler une suppression en attente ou un groupe de suppressions en attente avec la méthode CancelBatch.

Si la tentative de suppression d’enregistrements échoue en raison d’un conflit avec les données sous-jacentes (par exemple, si un enregistrement a déjà été supprimé par un autre utilisateur), le fournisseur retourne des avertissements à la collection Errors, mais ne cesse pas l’exécution du programme. Une erreur d’exécution ne se produit que s’il existe des conflits sur tous les enregistrements demandés.

Si la propriété dynamique Unique Table est définie et que l’objet Recordset est le résultat de l’exécution d’une opération JOIN sur plusieurs tables, la méthode Delete supprime uniquement les lignes de la table nommée dans la propriété Unique Table.

S'applique à

Recordset, objet (ADO)

Voir aussi

Delete, exemple de méthode (VB)
Delete, exemple de méthode (VBScript)
Delete, exemple de méthode (VC++)
Delete, méthode (collection Fields ADO)
Delete, méthode (collection Parameters ADO)
DeleteRecord, méthode (ADO)