Implementing a BulkSpecificFinder
Last modified: April 18, 2010
Applies to: SharePoint Server 2010
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, ...)