OrganizationServiceContext.AddObject Method

Article
06/20/2014

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

Adds the specified entity to the set of entities that the OrganizationServiceContext is tracking.

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

Syntax

'Declaration
Public Sub AddObject ( _
    entity As Entity _
)

public void AddObject (
    Entity entity
)

Parameters

entity
Type: Entity. The entity to be tracked by the OrganizationServiceContext.

Remarks

The entity is put into the tracking set of the OrganizationServiceContext in the Added state. The OrganizationServiceContext will attempt to insert the entity into the CRM on the next call to the SaveChanges. This method does not add entities related to the specified entity to the OrganizationServiceContext. Each object must be added through a separate call to AddObject.

The method does not validate that the entity set specified is in the Web service associated with the OrganizationServiceContext or that the added entity has the required attributes needed to be added to the specified entity set.

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