OriginalValue

(PWS4 IIS4 IIS5)
OriginalValue — 変更が行われる前のレコードの Field 値を示します。

構文

object.OriginalValue

パラメータ

object Fields オブジェクトを指定します。

戻り値

変更前のフィールドの値をバリアント型 (Variant) の値で返します。

説明

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

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

” バッチ更新モード” (プロバイダが複数の変更をキャッシュし、UpdateBatch メソッドが呼び出されたときにだけ基になるデータソースに書き込むモード) では、OriginalValue プロパティは、変更前 (最後の UpdateBatch メソッドの呼び出し以後) のフィールド値を返します。この値は、Value プロパティを置き換えるために CancelBatch メソッドが使用する値と同じです。UnderlyingValue プロパティと共にこのプロパティを使用すると、バッチ更新で発生する競合を解決することができます。

Recordについて

Record オブジェクトの場合、Update の呼び出し前に追加されたフィールドの OriginalValue プロパティは空になります。