ObjectContext.ApplyPropertyChanges(String, Object) メソッド

定義

名前空間:

System.Data.Objects

アセンブリ:

System.Data.Entity.dll

注意事項

Use ApplyCurrentValues instead

デタッチしたオブジェクトのプロパティの変更を、オブジェクト コンテキストに既にアタッチされているオブジェクトに適用します。

public:
 void ApplyPropertyChanges(System::String ^ entitySetName, System::Object ^ changed);

[System.ComponentModel.Browsable(false)]
[System.Obsolete("Use ApplyCurrentValues instead")]
public void ApplyPropertyChanges (string entitySetName, object changed);

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("Use ApplyCurrentValues instead")>]
member this.ApplyPropertyChanges : string * obj -> unit

Public Sub ApplyPropertyChanges (entitySetName As String, changed As Object)

パラメーター

entitySetName

String

オブジェクトが属しているエンティティ セットの名前。

changed

Object

元のオブジェクトに適用するプロパティ更新を含むデタッチしたオブジェクト。

属性

BrowsableAttribute ObsoleteAttribute

例外

ArgumentNullException

entitySetName が null または空の文字列である場合。

- または -

changed が null の場合。

InvalidOperationException

entitySetName の EntitySet が、オブジェクトの EntityKey の EntitySet と一致しない場合。

- または -

エンティティの状態が Modified または Unchanged 以外の場合。

- または -

元のオブジェクトがコンテキストにアタッチされていません。

ArgumentException

changed オブジェクトの型が元のオブジェクトの型とは異なる場合。

注釈

ApplyCurrentValues メソッドは、変更されたデタッチ済みバージョンのオブジェクトのプロパティの変更を、ObjectContext にアタッチされている元のバージョンに適用するために使用されます。 これにより、Web サービスで、エンティティ オブジェクトをデタッチして、プロパティ更新が行われるリモート アプリケーションに送信するといったシナリオがサポートされます。 このメソッドを使用すると、より簡単に変更内容を元のオブジェクトに適用し直すことができます。

ApplyCurrentValues の呼び出し後、オブジェクトの状態は Modified になります。 SaveChanges メソッドを呼び出してデータ ソースを更新する必要があります。

元のオブジェクトは ObjectStateManager に存在する必要があり、状態が Modified または Unchanged である必要があります。 元のオブジェクトは、オブジェクトに changed 変更されたプロパティがある場合にのみ変更されます。

指定されたオブジェクトの EntityKey プロパティは、有効な EntityKey に設定する必要があります。

ApplyCurrentValues は、ナビゲーション プロパティや関連オブジェクトには影響しません。

ApplyCurrentValues では、特定の型のエンティティ メタデータに存在するプロパティのみが設定されます。 たとえば、部分クラスに追加されているプロパティは、ApplyCurrentValues 操作の対象にはなりません。