ObjectContext.ApplyPropertyChanges(String, Object) Metod

Definition

Namnområde:

System.Data.Objects

Sammansättning:

System.Data.Entity.dll

Varning

Use ApplyCurrentValues instead

Tillämpar egenskapsändringar från ett frånkopplat objekt på ett objekt som redan är kopplat till objektkontexten.

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)

Parametrar

entitySetName

String

Namnet på den entitet som objektet tillhör.

changed

Object

Det frånkopplade objektet som har egenskapsuppdateringar som ska tillämpas på det ursprungliga objektet.

Attribut

BrowsableAttribute ObsoleteAttribute

Undantag

ArgumentNullException

När entitySetName är null eller en tom sträng.

-eller-

När changed är null.

InvalidOperationException

När från EntitySetentitySetName inte matchar EntitySet objektets EntityKey.

-eller-

När entiteten är i ett annat tillstånd än Modified eller Unchanged.

-eller-

Det ursprungliga objektet är inte kopplat till kontexten.

ArgumentException

När objektets changed typ inte är av samma typ som det ursprungliga objektet.

Kommentarer

Metoden ApplyCurrentValues används för att tillämpa egenskapsändringar från en ändrad, frånkopplad version av ett objekt till den ursprungliga versionen som är kopplad till ObjectContext. Detta stöder scenarier, till exempel webbtjänster, där ett entitetsobjekt kopplas från och skickas till ett fjärrprogram där egenskapsuppdateringar görs. Med den här metoden kan du enklare tillämpa ändringarna på det ursprungliga objektet.

Efter ApplyCurrentValuesär objektet i Modified tillståndet . Du måste anropa SaveChanges metoden för att uppdatera datakällan.

Det ursprungliga objektet måste finnas i ObjectStateManager och måste vara i Modified tillståndet eller Unchanged . Det ursprungliga objektet ändras bara om det finns ändrade egenskaper i objektet changed .

Egenskapen EntityKey för det angivna objektet måste vara inställd på ett giltigt EntityKey.

ApplyCurrentValues påverkar inte navigeringsegenskaper eller relaterade objekt.

ApplyCurrentValues anger endast egenskaper som finns i entitetsmetadata för typen. Egenskaper som läggs till i en partiell klass ingår till exempel inte i åtgärden ApplyCurrentValues .