EntityExtensions.GetRelatedEntity<TEntity> Method (Entity, String, Nullable<EntityRole>)

Applies To: Dynamics CRM 2013

Retrieves the related entity for a specific relationship.

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

Syntax

public static TEntity GetRelatedEntity<TEntity>(
    this Entity entity,
    string relationshipSchemaName,
    Nullable<EntityRole> primaryEntityRole = null
)
where TEntity : Entity

public:
generic<typename TEntity>
where TEntity : Entity
[ExtensionAttribute]
static TEntity GetRelatedEntity(
    Entity^ entity,
    String^ relationshipSchemaName,
    Nullable<EntityRole> primaryEntityRole = null
)

static member GetRelatedEntity<'TEntity when 'TEntity : Entity> : 
        entity:Entity *
        relationshipSchemaName:string *
        primaryEntityRole:Nullable<EntityRole> = null -> 'TEntity

<ExtensionAttribute>
Public Shared Function GetRelatedEntity(Of TEntity As Entity) (
    entity As Entity,
    relationshipSchemaName As String,
    primaryEntityRole As Nullable(Of EntityRole)
) As TEntity

Parameters

• entity
  Type: Microsoft.Xrm.Sdk.Entity

  Type: Entity. The entity instance.

• relationshipSchemaName
  Type: System.String

  Type: String. The schema name of the relationship.

• primaryEntityRole
  Type: System.Nullable<EntityRole>

  Type: Nullable<EntityRole>. The role that the entity plays in the relationship, referencing or referenced

Return Value

Type: TEntity

Type: Entity
The related entity for a specific relationship.

Type Parameters

• TEntity
  The type, where TEntity is an Entity.

Remarks

Extends the core GetRelatedEntity<TEntity> method.

See Also

GetRelatedEntity Overload
EntityExtensions Class
Microsoft.Xrm.Client Namespace

Return to top