Delete, méthode (Recordset ADO)
S’applique à : Access 2013, Office 2013
Supprime l'enregistrement actif ou un groupe d'enregistrements.
Syntaxe
recordset. Supprimer affectRecords
Paramètres
| Paramètre | Description |
|---|---|
| AffectRecords | Valeur AffectEnum qui détermine le nombre d'enregistrements concernés par la méthode Delete. La valeur par défaut est adAffectCurrent. |
Remarque
adAffectAll et adAffectAllChapters ne sont pas des arguments valides de la méthode Delete.
Remarques
L'utilisation de la méthode Delete marque pour suppression l'enregistrement actif ou un groupe d'enregistrements d'un objet Recordset. 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 sont effectuées immédiatement dans la base de données. S'il est impossible de supprimer un enregistrement (en raison de violations d'intégrité de la base de données, par exemple), l'enregistrement reste en mode édition après l'appel de la méthode Update. Cela signifie que vous devez annuler la mise à jour avec CancelUpdate avant de quitter l'enregistrement actif (par exemple, avec les méthodes Close, Move ou NextRecordset).
Si vous êtes en mode de mise à jour par lot, les enregistrements sont marqués pour suppression dans le cache et la suppression effective intervient lorsque vous appelez la méthode UpdateBatch. (Utilisez la propriété Filter pour consulter les enregistrements supprimés.)
Une tentative de récupération des valeurs des champs de l'enregistrement supprimé génère une erreur. Après la suppression de l'enregistrement actif, l'enregistrement supprimé reste actif jusqu'à ce que vous accédiez à un autre enregistrement. Dès que vous avez quitté l'enregistrement supprimé, ce dernier 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. En mode de mise à jour par lot, vous pouvez annuler une suppression en attente ou un groupe de suppressions en attente avec la méthode Cancel Batch.
Si la tentative de suppression des enregistrements échoue en raison d'un conflit avec les données sous-jacentes (par exemple, si un autre utilisateur a déjà supprimé un enregistrement), le fournisseur retourne des avertissements dans la collection Errors sans pour autant interrompre l'exécution du programme. Une erreur d'exécution se produit uniquement en cas de conflits sur tous les enregistrements demandés.
Si la propriété dynamique Unique Table est définie et que l'objet Recordset résulte 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.