ObjectContext.ApplyOriginalValues<TEntity>(String, TEntity) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定されたオブジェクトから、同じキーを持つ ObjectContext 内のオブジェクトの元の値のセットにスカラー値をコピーします。
public:
generic <typename TEntity>
where TEntity : class TEntity ApplyOriginalValues(System::String ^ entitySetName, TEntity originalEntity);
public TEntity ApplyOriginalValues<TEntity>(string entitySetName, TEntity originalEntity) where TEntity : class;
member this.ApplyOriginalValues : string * 'Entity -> 'Entity (requires 'Entity : null)
Public Function ApplyOriginalValues(Of TEntity As Class) (entitySetName As String, originalEntity As TEntity) As TEntity
型パラメーター
- TEntity
エンティティ オブジェクトの型。
パラメーター
- entitySetName
- String
オブジェクトが属するエンティティ セットの名前。
- originalEntity
- TEntity
オブジェクトに適用する元の値を持つデタッチされたオブジェクト。
originalEntityのエンティティ キーは、ObjectContext内のエントリのEntityKey プロパティと一致する必要があります。
返品
更新されたオブジェクト。
例外
entitySetName または originalEntity が null。
entitySetNameからのEntitySetは、オブジェクトのEntityKeyのEntitySetと一致しません。
-又は-
オブジェクトの ObjectStateEntry が ObjectStateManagerに見つかりません。 -又は-
オブジェクトが Added または Detached 状態です。
-又は-
指定されたオブジェクトのエンティティ キーが無効であるか、プロパティが変更されています。
entitySetName は空の文字列です。
注釈
ApplyOriginalValues メソッドは、Web サービスによって受信されたデタッチされたオブジェクトなど、ObjectContextの外部のオブジェクトに加えられた変更を適用するために使用されます。 メソッドは、指定されたオブジェクトから、同じキーを持つ ObjectContext 内のオブジェクトにスカラー値をコピーします。 デタッチされたオブジェクトの EntityKey を使用して、データ ソースからこのオブジェクトのインスタンスを取得できます。 オブジェクトの現在の値と異なる値は、変更済みとしてマークされます。 メソッドは、 originalEntityの関連オブジェクトに現在の値を適用しないことに注意してください。
元の値を持つグラフがあり、現在の値を適用する場合は、 ApplyCurrentValues メソッドを呼び出します。
また、ObjectStateEntryのObjectSet<TEntity>またはApplyOriginalValuesメソッドのApplyOriginalValuesを使用することもできます。