Implementing a BulkSpecificFinder

SharePoint 2010

Last modified: April 18, 2010

Applies to: SharePoint Server 2010

In this article

A BulkSpecificFinder method instance returns external items corresponding to given Identities.

This stereotype enables querying for multiple items given a collection of identifiers.

To support this stereotype, the corresponding method should take a collection of identifiers as input and return a detailed view for each of the items. All other requirements are exactly the same as for a specific finder.

The IEntityInstanceEnumerator returned from this method must throw a PartialBulkReadException on the MoveNext method, if the external system returns fewer items than requested after all the returned items have been enumerated. It must also throw a InvalidOperationException if the external system returns duplicate items or if it returns more items than requested.

This method returns an IEntityInstanceEnumerator.

Following is the typical method signature for a BulkSpecificFinder:

EntityDataType[] GetEntityByIds(IdType1[] id1, idType2[] id2, ...)