OriginalValue プロパティ

変更を行う前にレコード内に存在した Field の値を示します。

戻り値

バリアント型 (Variantの値を返します。

解説

OriginalValue プロパティは、カレント レコードからのフィールドの元のフィールド値を返すために使います。

即時更新モード (1 回の Update メソッド呼び出しでプロバイダが変更内容をデータ元のデータ ソースに書き込むモード) では、OriginalValue プロパティは変更前 (直前の Update メソッド呼び出しの前) に存在していたフィールド値を返します。この値は、CancelUpdate メソッドが Value プロパティを置き換えるために使用する値と同じです。

バッチ更新モード (プロバイダが変更内容をキャッシュに蓄積しておき、UpdateBatch メソッドを呼び出したときだけデータ元のデータ ソースに書き込むモード) では、OriginalValue プロパティは変更前 (直前の UpdateBatch メソッド呼び出しの前) に存在していたフィールド値を返します。この値は、CancelBatch メソッドが Value プロパティを置き換えるために使用する値と同じです。このプロパティと UnderlyingValue プロパティを使うと、バッチ更新の際に発生する競合を解決することができます。

対象

Field

関連項目

UnderlyingValue