Entity.FindAssociated Method (EntityInstanceCollection, FilterCollection, LobSystemInstance)

Gets filtered 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, _
    filters As FilterCollection, _
    lobSystemInstance As LobSystemInstance _
) As IEntityInstanceEnumerator

'Usage
Dim instance As Entity
Dim sourceEntityInstances As EntityInstanceCollection
Dim filters As FilterCollection
Dim lobSystemInstance As LobSystemInstance
Dim returnValue As IEntityInstanceEnumerator

returnValue = instance.FindAssociated(sourceEntityInstances, _
    filters, lobSystemInstance)

public IEntityInstanceEnumerator FindAssociated(
    EntityInstanceCollection sourceEntityInstances,
    FilterCollection filters,
    LobSystemInstance lobSystemInstance
)

Parameters

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

• filters
  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 tries to infer which Association to use, by finding all Associations where this Entity is the Destination. If more than one Association is found, this method will throw.

See Also

Reference

Entity Class

Entity Members

FindAssociated Overload

Microsoft.Office.Server.ApplicationRegistry.MetadataModel Namespace