IEntity.FindSpecificMultiple Method (IList<Identity>, ILobSystemInstance)
Gets a group of external items using the specified external item identities, the default OperationMode object, and the BulkSpecificFinder MethodInstance.
Namespace: Microsoft.BusinessData.MetadataModel
Assembly: Microsoft.BusinessData (in Microsoft.BusinessData.dll)
Syntax
'Declaration
Function FindSpecificMultiple ( _
identities As IList(Of Identity), _
lsi As ILobSystemInstance _
) As IEntityInstanceEnumerator
'Usage
Dim instance As IEntity
Dim identities As IList(Of Identity)
Dim lsi As ILobSystemInstance
Dim returnValue As IEntityInstanceEnumerator
returnValue = instance.FindSpecificMultiple(identities, _
lsi)
IEntityInstanceEnumerator FindSpecificMultiple(
IList<Identity> identities,
ILobSystemInstance lsi
)
Parameters
identities
Type: System.Collections.Generic.IList<Identity>The set of identities to retrieve external content type instances for.
lsi
Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstanceThe LobSystem instance to execute the bulk specific finder against.
Return Value
Type: Microsoft.BusinessData.Runtime.IEntityInstanceEnumerator
A group of external items.
Remarks
The IEntityInstanceEnumerator returned from this method will 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 will also throw a InvalidOperationException if the external system returns duplicate items or more items than requested.
This method returns an IEntityInstanceEnumerator, which requires special clean up and may expose additional functionality to control the behavior when the external system returns data in batches. For more information about how to use external item enumerators, see IEntityInstanceEnumerator.
The mode of operation can be specified for this method. For more information about how to use operation modes, see OperationMode.
Instances of objects in the Business Data Connectivity object model are tied to the Metadata Store they are obtained from. Using instances tied to one Metadata Store with the instances from another Metadata Store will cause data corruption and other unexpected behavior. For more information, see DatabaseBackedMetadataCatalog, FileBackedMetadataCatalog, and RemoteSharedFileBackedMetadataCatalog.