ObjectContext.ApplyPropertyChanges(String, Object) Метод

  • Ссылка

Определение

Пространство имен:
System.Data.Objects
Сборка:
System.Data.Entity.dll

Внимание!

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

Отсоединенный объект имеет обновления свойств, которые нужно применить к исходному объекту.

Атрибуты
BrowsableAttribute ObsoleteAttribute

Исключения

ArgumentNullException

Если entitySetName равно null или пустая строка.

-или-

Если значение параметра changed равно null.

InvalidOperationException

Когда набор сущностей EntitySet из параметра entitySetName не совпадает с набором сущностей EntitySet ключа EntityKey объекта.

-или-

Сущность находится в состоянии, отличном от Modified или Unchanged.

-или-

Исходный объект не присоединен к контексту.

ArgumentException

Когда тип объекта changed отличается от типа исходного объекта.

Комментарии

Метод ApplyCurrentValues используется, чтобы применять изменения свойств от измененной, отсоединенной версии объекта к исходной версии, присоединенной к контексту ObjectContext. Это обеспечивает поддержку таких сценариев, как веб-службы, в которых объект сущности отсоединяется и отправляется удаленному приложению, где выполняется обновление свойств. Этот метод упрощает применение этих изменений назад к исходному объекту.

После выполнения метода ApplyCurrentValues объект находится в состоянии Modified. Для обновления источника данных необходимо вызвать SaveChanges метод .

Исходный объект должен существовать в диспетчере ObjectStateManager и должен находиться в состоянии Modified или Unchanged. Исходный объект изменяется только при наличии измененных свойств в объекте changed .

Свойству EntityKey предоставленного объекта должно быть присвоено допустимое EntityKeyзначение .

ApplyCurrentValues не влияет на свойства навигации или связанные объекты.

Метод ApplyCurrentValues задает только те свойства, которые существуют в метаданных сущности для этого типа. Например, свойства, которые добавлены в разделяемый класс, не включаются в операцию ApplyCurrentValues.

Применяется к