Implementing an AssociationNavigator

SharePoint 2010

Last modified: April 20, 2010

Applies to: SharePoint Server 2010

In this article

An AssociationNavigator method instance enables you to get external items that are related to given external items, from the external system. This stereotype enables an association in Microsoft Business Connectivity Services (BCS). For example, given a business object named Customer, this stereotype can be used to get all the related orders of that customer.

Following are the typical method signatures for AssociationNavigator methods:

DestinationEntityDataType[] FindAssociated(sourceId1Type id1, ...)
DestinationEntityDataType FindAssociated(sourceId1Type id1, ...)

To qualify as an AssociationNavigator, the corresponding method should:

  • Take an item as input for every source external content type of the AssociationNavigator.

  • Return an IEntityInstanceEnumerator that contains the external items that are associated with the given external items, that are based on the destination external content type.

Note Note

We recommend that the method provide rich filtering, especially if it returns many external items. For more information about how to use filters, see IFilterCollection.