ObjectContext.ApplyPropertyChanges(String, Object) Método

Definição

Namespace:

System.Data.Objects

Assembly:

System.Data.Entity.dll

Cuidado

Use ApplyCurrentValues instead

Aplica alterações de propriedade de um objeto desanexado a um objeto que já está anexado ao contexto de objeto.

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)

Parâmetros

entitySetName

String

O nome do conjunto de entidades a que o objeto pertence.

changed

Object

O objeto desanexado que tem atualizações de propriedade a serem aplicadas ao objeto original.

Atributos

BrowsableAttribute ObsoleteAttribute

Exceções

ArgumentNullException

Quando entitySetName é null ou uma cadeia de caracteres vazia.

- ou -

Quando changed é null.

InvalidOperationException

Quando o EntitySet de entitySetName não corresponde ao EntitySet do EntityKey do objeto.

- ou -

Quando a entidade está em um estado diferente de Modified ou Unchanged.

- ou -

O objeto original não está anexado ao contexto.

ArgumentException

Quando o tipo do objeto changed não é do mesmo tipo que o objeto original.

Comentários

O ApplyCurrentValues método é usado para aplicar alterações de propriedade de uma versão modificada e desanexada de um objeto à versão original anexada ao ObjectContext. Isso dá suporte a cenários, como serviços Web, em que um objeto de entidade é desanexado e enviado para um aplicativo remoto onde são feitas atualizações de propriedade. Esse método permite que você aplique mais facilmente essas alterações ao objeto original.

Depois ApplyCurrentValuesde , o objeto está no Modified estado . Você deve chamar o SaveChanges método para atualizar a fonte de dados.

O objeto original deve existir no ObjectStateManager e deve estar no Modified estado ou Unchanged . O objeto original só será modificado se houver propriedades modificadas no changed objeto .

A EntityKey propriedade do objeto fornecido deve ser definida como uma válida EntityKey.

ApplyCurrentValues não afeta propriedades de navegação ou objetos relacionados.

ApplyCurrentValues define apenas as propriedades que existem nos metadados de entidade para o tipo. Por exemplo, as propriedades adicionadas em uma classe parcial não são incluídas na ApplyCurrentValues operação.