EditMode, propriété
Indique l’état de modification de l’enregistrement actif.
Valeur de retour
Retourne une valeur EditModeEnum.
Remarques
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 à la méthode Update est appelée. Lorsqu’un appel à Delete ne supprime pas correctement l’enregistrement ou les enregistrements de la source de données (par exemple, en raison de violations d’intégrité référentielle), le jeu d’enregistrements reste en mode édition (EditMode = adEditInProgress). Par conséquent, cancelUpdate doit être appelée avant de désactiver l’enregistrement actif (par exemple, avec Move, NextRecordsetou Fermer).
Dans 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é de EditMode sera toujours adEditAdd. La propriété EditMode n’est pas réinitialisée à adEditNone jusqu’à ce que l’appel à UpdateBatch. Pour déterminer quelles opérations ont été effectuées, définissez la propriété Filter sur adFilterPending afin que seuls les enregistrements ayant des modifications en attente soient visibles et examinent la propriété Status de chaque enregistrement pour déterminer les modifications apportées aux données.
Note
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 actif a été supprimé.
S’applique à
Voir aussi
CursorType, LockType et EditMode Properties Example (VB)
CursorType, LockType et EditMode Properties Example (VC++)
AddNew, méthode (ADO)
Delete, méthode (jeu d’enregistrements ADO)
CancelUpdate, méthode (ADO)
Update, méthode