Share via


OrganizationServiceContext.AddLink(Entity, Relationship, Entity) Method

Definition

Adds the specified link to the set of objects the OrganizationServiceContext is tracking.

public:
 void AddLink(Microsoft::Xrm::Sdk::Entity ^ source, Microsoft::Xrm::Sdk::Relationship ^ relationship, Microsoft::Xrm::Sdk::Entity ^ target);
public void AddLink (Microsoft.Xrm.Sdk.Entity source, Microsoft.Xrm.Sdk.Relationship relationship, Microsoft.Xrm.Sdk.Entity target);
member this.AddLink : Microsoft.Xrm.Sdk.Entity * Microsoft.Xrm.Sdk.Relationship * Microsoft.Xrm.Sdk.Entity -> unit
Public Sub AddLink (source As Entity, relationship As Relationship, target As Entity)

Parameters

source
Entity

The source entity for the new link.

relationship
Relationship

The navigation property or attribute on the source object that returns the related object.

target
Entity

The entity related to the source entity by the new link.

Remarks

Notifies the OrganizationServiceContext that a new link exists between the related source and target objects and that the link is represented by the specified entity attribute or navigation property. The OrganizationServiceContext adds this link to the set of newly created links that are sent to the Web service on the next call to SaveChanges() method.Links are one-way relationships. Because associations are bi-directional, in a one-to-one association you must call AddLink(Entity, Relationship, Entity) again to create the reverse link.

Applies to