OriginalValue, propriété (ADO)

S’applique à : Access 2013, Office 2013

Indique la valeur d'un objet Field existant dans l'enregistrement avant qu'aucune modification n'ait été apportée.

Valeur renvoyée

Renvoie une valeur Variant représentant la valeur d'un champ avant modification.

Remarques

Utilisez la propriété OriginalValue pour renvoyer la valeur d'origine d'un champ depuis l'enregistrement actuel.

En mode de mise à jour immédiate (dans lequel le fournisseur écrit les modifications dans la source de données sous-jacente après avoir appelé la méthode Update ), la propriété OriginalValue retourne la valeur de champ qui existait avant toute modification (c’est-à-dire, depuis le dernier appel de méthode Update ). C'est la même valeur que la méthode CancelUpdate utilise pour remplacer la propriété Value.

En mode de mise à jour par lot (dans lequel le fournisseur met en cache plusieurs modifications et ne les inscrit dans la source de données sous-jacente que lorsque vous appelez la méthode UpdateBatch), la propriété OriginalValue renvoie la valeur du champ avant modification (c’est-à-dire avant le dernier appel de la méthode UpdateBatch). C’est cette valeur que la méthode CancelBatch utilise pour remplacer la propriété Value. Lorsque vous utilisez cette propriété en association avec la propriété UnderlyingValue, vous pouvez résoudre les conflits générés par les mises à jour par lot.

Enregistrement

Pour les objets Record, la propriété OriginalValue est vide pour les champs ajoutés avant l’appel de la méthode Update.