OrganizationServiceContext.AddLink Method

Article
06/20/2014

Applies To: Microsoft Dynamics CRM 2013, Microsoft Dynamics CRM Online

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

Namespace: Microsoft.Xrm.Sdk.Client
Assembly: Microsoft.Xrm.Sdk (in Microsoft.Xrm.Sdk.dll)

Syntax

'Declaration
Public Sub AddLink ( _
    source As Entity, _
    relationship As Relationship, _
    target As Entity _
)

public void AddLink (
    Entity source,
    Relationship relationship,
    Entity target
)

Parameters

source
Type: Entity. The source entity for the new link.

relationship
Type: Relationship. The navigation property or attribute on the source object that returns the related object.

target
Type: 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 again to create the reverse link.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows Server 2008, Windows Server 2012, Windows 7 (All Versions), Windows 8 (All Versions)

Target Platforms

Windows Server 2008, ,Windows Server 2012, ,Windows 7 (All Versions),