OrganizationServiceProxy.Associate Method

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

Creates a link between records.

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

Syntax

'Declaration
Public Sub Associate ( _
    entityName As String, _
    entityId As Guid, _
    relationship As Relationship, _
    relatedEntities As EntityReferenceCollection _
)

public void Associate (
    string entityName,
    Guid entityId,
    Relationship relationship,
    EntityReferenceCollection relatedEntities
)

Parameters

• entityName
  Type: String. The logical name of the entity specified in the entityId parameter.

• entityId
  Type: Guid. The ID of the record to which the related records will be associated.

• relationship
  Type: Relationship. The name of the relationship to be used to create the link.

• relatedEntities
  Type: EntityReferenceCollection. A collection of entity references (references to records) to be associated.

Remarks

The core implementation of the Associate method. For more information, see IOrganizationService.Associate.

For more information about the exceptions that can be thrown when calling OrganizationServiceProxy methods, see Handle Exceptions in Your Code.

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

See Also

Reference

OrganizationServiceProxy Class
OrganizationServiceProxy Members
Microsoft.Xrm.Sdk.Client Namespace
Entity Metadata

Other Resources

Troubleshooting and Error Handling
Read and Write Data and Metadata using the IOrganizationService Web Service
Customize Entity Relationship Metadata

Send comments about this topic to Microsoft.
© 2013 Microsoft Corporation. All rights reserved.