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

NOTE: This API is now obsolete.

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
<ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.",  _
    False)> _
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)

[ObsoleteAttribute("O12 Application Registry API is deprecated. Please use BusinessData.", 
    false)]
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