ObjectContext.ApplyOriginalValues<TEntity>(String, TEntity) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Copia os valores escalares do objeto fornecido para um conjunto de valores originais para o objeto no ObjectContext que tem a mesma chave.
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
Parâmetros de tipo
- TEntity
O tipo do objeto de entidade.
Parâmetros
- entitySetName
- String
O nome do conjunto de entidades a que o objeto pertence.
- originalEntity
- TEntity
O objeto desanexado que tem valores originais a serem aplicadas ao objeto. A chave de entidade do originalEntity
deve corresponder à propriedade EntityKey de uma entrada no ObjectContext.
Retornos
O objeto atualizado.
Exceções
entitySetName
ou original
é null
.
O EntitySet de entitySetName
não corresponde ao EntitySet do EntityKey do objeto.
- ou -
Um ObjectStateEntry para o objeto não foi encontrado no ObjectStateManager. - ou -
O objeto está em um estado Added ou Detached.
- ou -
A chave de entidade do objeto fornecido é inválida ou tem alterações de propriedade.
entitySetName
é uma cadeia de caracteres vazia.
Comentários
O ApplyOriginalValues método é usado para aplicar alterações feitas a objetos fora do ObjectContext, como objetos desanexados recebidos por um serviço Web. O método copia os valores escalares do objeto fornecido para o objeto no ObjectContext que tem a mesma chave. Você pode usar o EntityKey do objeto desanexado para recuperar uma instância desse objeto da fonte de dados. Para obter mais informações, consulte Como retornar um objeto específico usando sua chave. Todos os valores que diferem dos valores atuais do objeto são marcados como modificados. Observe que o método não aplica os valores atuais aos objetos relacionados de originalEntity
.
Se você tiver um grafo com os valores originais e quiser aplicar os valores atuais, chame ApplyCurrentValues o método .
Você também pode usar o ApplyOriginalValuesObjectSet<TEntity> do método ou ApplyOriginalValues do ObjectStateEntry. Para obter mais informações, consulte Como criar aplicativos de N Camadas.