ObjectContext.ApplyPropertyChanges(String, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Внимание!
Use ApplyCurrentValues instead
Применяет изменения свойств из отсоединенного объекта к объекту, который уже присоединен к контексту объекта.
public:
void ApplyPropertyChanges(System::String ^ entitySetName, System::Object ^ changed);
public void ApplyPropertyChanges (string entitySetName, object changed);
[System.ComponentModel.Browsable(false)]
[System.Obsolete("Use ApplyCurrentValues instead")]
public void ApplyPropertyChanges (string entitySetName, object changed);
member this.ApplyPropertyChanges : string * obj -> unit
[<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
Отсоединенный объект имеет обновления свойств, которые нужно применить к исходному объекту.
- Атрибуты
Исключения
Если entitySetName
равно null
или пустая строка.
-или-
Если значение параметра changed
равно null
.
Когда набор сущностей EntitySet из параметра entitySetName
не совпадает с набором сущностей EntitySet ключа EntityKey объекта.
-или-
Сущность находится в состоянии, отличном от Modified или Unchanged.
-или-
Исходный объект не присоединен к контексту.
Когда тип объекта changed
отличается от типа исходного объекта.
Комментарии
Метод ApplyCurrentValues используется, чтобы применять изменения свойств от измененной, отсоединенной версии объекта к исходной версии, присоединенной к контексту ObjectContext. Это обеспечивает поддержку таких сценариев, как веб-службы, в которых объект сущности отсоединяется и отправляется удаленному приложению, где выполняется обновление свойств. Этот метод упрощает применение этих изменений назад к исходному объекту.
После выполнения метода ApplyCurrentValues объект находится в состоянии Modified. Для обновления источника данных необходимо вызвать SaveChanges метод .
Исходный объект должен существовать в диспетчере ObjectStateManager и должен находиться в состоянии Modified или Unchanged. Исходный объект изменяется только при наличии измененных свойств в объекте changed
.
Свойству EntityKey предоставленного объекта должно быть присвоено допустимое EntityKeyзначение .
ApplyCurrentValues не влияет на свойства навигации или связанные объекты.
Метод ApplyCurrentValues задает только те свойства, которые существуют в метаданных сущности для этого типа. Например, свойства, которые добавлены в разделяемый класс, не включаются в операцию ApplyCurrentValues.