Entity.FindAssociated Method (EntityInstanceCollection, Association, FilterCollection, LobSystemInstance)

Gets the entity instances associated with a given entity instance collection.

Namespace:  Microsoft.Office.Server.ApplicationRegistry.MetadataModel
Assembly:  Microsoft.SharePoint.Portal (in Microsoft.SharePoint.Portal.dll)

Syntax

'Declaration
Public Function FindAssociated ( _
    sourceEntityInstances As EntityInstanceCollection, _
    association As Association, _
    filterCollection As FilterCollection, _
    lobSystemInstance As LobSystemInstance _
) As IEntityInstanceEnumerator

'Usage
Dim instance As Entity
Dim sourceEntityInstances As EntityInstanceCollection
Dim association As Association
Dim filterCollection As FilterCollection
Dim lobSystemInstance As LobSystemInstance
Dim returnValue As IEntityInstanceEnumerator

returnValue = instance.FindAssociated(sourceEntityInstances, _
    association, filterCollection, lobSystemInstance)

public IEntityInstanceEnumerator FindAssociated(
    EntityInstanceCollection sourceEntityInstances,
    Association association,
    FilterCollection filterCollection,
    LobSystemInstance lobSystemInstance
)

Parameters

• sourceEntityInstances
  Type: Microsoft.Office.Server.ApplicationRegistry.Runtime.EntityInstanceCollection
  The collection containing the source entity instances. It must contain one instance of each Entity that is a Source in the Association.

• association
  Type: Microsoft.Office.Server.ApplicationRegistry.MetadataModel.Association
  The Association object.

• filterCollection
  Type: Microsoft.Office.Server.ApplicationRegistry.Runtime.FilterCollection
  The FilterCollection object. It must contain the Filters returned by calling the .GetFilters() method on the Association. Each filter returned may have its value set before being used here to return a filtered set of destination Entity Instances.

• lobSystemInstance
  Type: Microsoft.Office.Server.ApplicationRegistry.MetadataModel.LobSystemInstance
  The LobSystemInstance object.

Return Value

Type: Microsoft.Office.Server.ApplicationRegistry.Runtime.IEntityInstanceEnumerator
An entity instance collection enumerator.

Remarks

This form of FindAssociated explicitly requests which Association to use from the user. This Entity must be a destination in the Association.

See Also

Reference

Entity Class

Entity Members

FindAssociated Overload

Microsoft.Office.Server.ApplicationRegistry.MetadataModel Namespace