Méthode Delete (objet Recordset d'ADO)
Supprime l'enregistrement en cours ou un groupe d'enregistrements.
Syntaxe
recordset.Delete AffectRecords
Paramètres
AffectRecords Valeur AffectEnum qui détermine le nombre d'enregistrements auxquels la méthode Delete sera appliquée. Vous pouvez utiliser l'une des constantes suivantes :
Constante Description
adAffectCurrent Valeur utilisée par défaut. Supprime uniquement l'enregistrement en cours.
adAffectGroup Supprime les enregistrements qui correspondent aux paramètres en cours de la propriété Filter. Pour pouvoir utiliser cette option, vous devez affecter la propriété Filter de l'une des constantes prédéfinies admises.
Remarques
L'utilisation de la méthode Delete marque l'enregistrement en cours ou un groupe d'enregistrements d'un objet Recordset en vue d'une suppression. Si l'objet Recordset ne permet pas la suppression d'enregistrements, une erreur se produit. Si vous êtes en mode de mise à jour immédiate, la suppression s'effectue immédiatement dans la base de données. Sinon, les enregistrements sont marqués en vue d'une suppression à partir de la mémoire cache et leur suppression effective n'aura lieu que lorsque vous appellerez la méthode UpdateBatch. (Utilisez la propriété Filter pour afficher les enregistrements supprimés.)
L'extraction des valeurs des champs de l'enregistrement supprimé génère une erreur. Suite à sa suppression, l'enregistrement demeure en cours jusqu'à ce que vous sélectionniez un autre enregistrement. Par conséquent, dès lors que vous quittez un enregistrement supprimé, celui-ci ne sera plus accessible.
Si vous imbriquez des suppressions dans une transaction, vous pouvez restaurer les enregistrements supprimés à l'aide de la méthode RollbackTrans. Si vous êtes en mode de mise à jour par lots, vous pouvez annuler une suppression ou un groupe de suppressions en attente à l'aide de la méthode CancelBatch.
En cas d'échec de la tentative de suppression d'enregistrements, provoquée par un conflit avec les données sous-jacentes (par exemple, un enregistrement ayant déjà été supprimé par un autre utilisateur), le fournisseur renvoie des avertissements à la collection Errors mais n'arrête pas l'exécution du programme. Une erreur d'exécution intervient uniquement en cas de conflit sur tous les enregistrements demandés.
Partager