DataServiceContext.SetLink(Object, String, Object) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Уведомляет DataServiceContext, что имеется новая ссылка между указанными объектами и что ссылка представлена свойством, указанным параметром sourceProperty
.
public virtual void SetLink (object source, string sourceProperty, object target);
abstract member SetLink : obj * string * obj -> unit
override this.SetLink : obj * string * obj -> unit
Public Overridable Sub SetLink (source As Object, sourceProperty As String, target As Object)
Параметры
- source
- Object
Исходный объект для новой ссылки.
- sourceProperty
- String
Свойство исходного объекта, определяющего целевой объект новой ссылки.
- target
- Object
Дочерний объект в новой ссылке, который должен быть инициализирован путем вызова данного метода. Целевой объект должен иметь подтип типа, определяемого параметром sourceProperty
. Если target
задано неопределенное значение, вызов представляет операцию удаления ссылки.
Исключения
Если source
, sourceProperty
или target
имеют значение NULL.
Если указанная ссылка уже существует.-или-When объекты, предоставленные как source
или target
находятся в Detached состоянии или Deleted .-or-When sourceProperty
не является свойством навигации, определяющим ссылку на один связанный объект.
Комментарии
Уведомляет контекст о том, что между объектами source
и существует target
измененная связь и что связь представлена через источник.sourceProperty
который является ссылкой. Контекст добавляет эту ссылку в набор измененных созданных ссылок для отправки в службу данных при следующем вызове SaveChanges(). Ссылки являются односторонными связями. Если существует обратный указатель (т. е. двустороннее сопоставление), этот метод следует вызывать во второй раз, чтобы уведомить объект контекста о второй ссылке.