Delete, méthode (objet Recordset ADO)
Supprime l’enregistrement actif ou un groupe d’enregistrements.
Syntaxe
recordset.Delete AffectRecords
Paramètres
AffectRecords
Valeur AffectEnum qui détermine le nombre d’enregistrements que la méthode Delete affectera. La valeur par défaut est adAffectCurrent.
Note
adAffectAll et adAffectAllChapters ne sont pas des arguments valides pour Supprimer.
Remarques
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 d’enregistrements, une erreur se produit. Si vous êtes en mode de 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 d’intégrité de la base de données, par exemple), l’enregistrement reste en mode d’édition après l’appel à Mise à jour. Cela signifie que vous devez annuler la mise à jour avec CancelUpdate avant de désactiver l’enregistrement actif (par exemple, avec Fermer, Déplacerou NextRecordset).
Si vous êtes en mode de mise à jour par lots, 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 passez à 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, un enregistrement a déjà été supprimé par un autre utilisateur), le fournisseur retourne des avertissements à la collection Errors, mais n’interrompt pas l’exécution du programme. Une erreur d’exécution se produit uniquement s’il existe des conflits sur tous les enregistrements demandés.
Si la propriété dynamique table unique est définie et que le jeu d’enregistrements 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é Table unique.
S’applique à
Voir aussi
Delete, méthode - Exemple (VB)
Delete, méthode - Exemple (VBScript)
Delete, méthode - Exemple (VC++)
méthode Delete (collection de champs ADO)
méthode Delete (collection ADO Parameters)
DeleteRecord, méthode (ADO)