OrganizationServiceContext.AddRelatedObject Method

Article
06/20/2014

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

Adds a related entity to the OrganizationServiceContext and creates the link that defines the relationship between the two entities in a single request.

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

Syntax

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

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

Parameters

source
Type: Entity. The parent entity that is being tracked by the context.

relationship
Type: Relationship. The name of the attribute or navigation property that returns the related object based on an association between the two entities.

target
Type: Entity. The related object that is being added.

Remarks

This method essentially works by calling AddObject and AddLink.

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),