ObjectContext.ApplyOriginalValues<TEntity>(String, TEntity) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Копирует скалярные значения из переданного объекта в набор исходных значений для объекта в 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
должен совпадать со свойством EntityKey сущности в контексте ObjectContext.
Возвращаемое значение
Обновленный объект.
Исключения
Параметр entitySetName
или original
имеет значение null
.
Набор сущностей EntitySet из параметра entitySetName
не совпадает с набором сущностей EntitySet ключа EntityKey объекта.
-или-
Для объекта не удается найти ObjectStateEntry в ObjectStateManager. -или-
Объект находится в состоянии Added или Detached.
-или-
Ключ сущности предоставленного объекта является недопустимым или имеет измененные свойства.
Параметр entitySetName
равен пустой строке.
Комментарии
Метод ApplyOriginalValues используется для применения изменений, которые были внесены в объекты за пределами ObjectContext, например отсоединенные объекты, полученные веб-службой. Метод копирует скалярные значения из предоставленного объекта в объект , ObjectContext имеющий тот же ключ. Для получения экземпляра этого объекта из источника данных можно использовать EntityKey атрибут отсоединяемого объекта. Дополнительные сведения см. в разделе Практическое руководство. Возвращение определенного объекта с помощью его ключа. Все значения, отличающиеся от текущих значений объекта, помечаются как измененные. Обратите внимание, что метод не применяет текущие значения к связанным объектам originalEntity
.
Если у вас есть граф с исходными значениями и вы хотите применить текущие значения, вызовите ApplyCurrentValues метод .
Можно также использовать ApplyOriginalValuesObjectSet<TEntity> метод ObjectStateEntryили ApplyOriginalValues объекта . Дополнительные сведения см. в статье Создание N-уровневых приложений.