IEntity.FindSpecificMultiple Method (IList<Identity>, String, ILobSystemInstance)
Gets a group of external items using the specified external item identities and the default OperationMode object.
Namespace: Microsoft.BusinessData.MetadataModel
Assembly: Microsoft.BusinessData (in Microsoft.BusinessData.dll)
Syntax
'Declaration
Function FindSpecificMultiple ( _
identities As IList(Of Identity), _
bulkSpecificFinderName As String, _
lsi As ILobSystemInstance _
) As IEntityInstanceEnumerator
'Usage
Dim instance As IEntity
Dim identities As IList(Of Identity)
Dim bulkSpecificFinderName As String
Dim lsi As ILobSystemInstance
Dim returnValue As IEntityInstanceEnumerator
returnValue = instance.FindSpecificMultiple(identities, _
bulkSpecificFinderName, lsi)
IEntityInstanceEnumerator FindSpecificMultiple(
IList<Identity> identities,
string bulkSpecificFinderName,
ILobSystemInstance lsi
)
Parameters
identities
Type: System.Collections.Generic.IList<Identity>The set of identities to retrieve external items for.
bulkSpecificFinderName
Type: System.StringThe name of the BulkSpecificFinder MethodInstance to execute.
lsi
Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstanceThe LobSystem instance to execute the BulkSpecificFinder MethodInstance 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.