EditMode, propriété

Indique l’état de modification de l’enregistrement actif.

Valeur renvoyée

Retourne une valeur EditModeEnum.

Notes

ADO gère une mémoire tampon d’édition associée à l’enregistrement actif. Cette propriété indique si des modifications ont été apportées à cette mémoire tampon ou si un nouvel enregistrement a été créé. Utilisez la propriété EditMode pour déterminer l’état de modification de l’enregistrement actif. Vous pouvez tester les modifications en attente si un processus d’édition a été interrompu et déterminer si vous devez utiliser la méthode Update ou CancelUpdate.

En mode de mise à jour immédiate, la propriété EditMode est réinitialisée à adEditNone après un appel réussi de la méthode Update. Lorsqu’un appel à Delete ne supprime pas correctement l’enregistrement ou les enregistrements dans la source de données (par exemple, en raison de violations de l’intégrité référentielle), l’objet Recordset reste en mode d’édition (EditMode = adEditInProgress). Par conséquent, CancelUpdate doit être appelé avant de quitter l’enregistrement actif (par exemple avec Move, NextRecordset ou Close).

En mode de mise à jour par lots (dans lequel le fournisseur met en cache plusieurs modifications et les écrit dans la source de données sous-jacente uniquement lorsque vous appelez la méthode UpdateBatch), la valeur de la propriété EditMode est modifiée lorsque la première opération est effectuée et qu’elle n’est pas réinitialisée par un appel à la méthode Update. Les opérations suivantes ne modifient pas la valeur de la propriété EditMode, même si différentes opérations sont effectuées. Par exemple, si la première opération consiste à ajouter un nouvel enregistrement et que la seconde apporte des modifications à un enregistrement existant, la propriété EditMode sera toujours adEditAdd. La propriété EditMode n’est pas réinitialisée à adEditNone tant que UpdateBatch n’a pas été appelé. Pour déterminer les opérations effectuées, définissez la propriété Filter sur adFilterPending afin que seuls les enregistrements avec des modifications en attente soient visibles et examinez la propriété Status de chaque enregistrement pour déterminer les modifications apportées aux données.

Notes

EditMode peut retourner une valeur valide uniquement s’il existe un enregistrement actif. EditMode retourne une erreur si BOF ou EOF a la valeur True ou si l’enregistrement actuel a été supprimé.

S'applique à

Recordset, objet (ADO)

Voir aussi

Exemple de propriétés CursorType, LockType et EditMode (VB)
Exemple de propriétés CursorType, LockType et EditMode (VC++)
AddNew, méthode (ADO)
Delete, méthode (objet Recordset ADO)
CancelUpdate, méthode (ADO)
Update, méthode