Export (0) Print
Expand All

IEntity.BulkEnumerateIdentities method

Enumerates the given identities.

Namespace:  Microsoft.BusinessData.MetadataModel
Assembly:  Microsoft.BusinessData (in Microsoft.BusinessData.dll)

IEntityInstanceEnumerator BulkEnumerateIdentities(
	IList<Identity> identities,
	ILobSystemInstance lobSystemInstance


Type: System.Collections.Generic.IList<Identity>

The given identities.

Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

The LobSystem instance.

This method can be used to optimize synchronization of cached data. This method ideally returns only the Identities and version information of the external items corresponding to given identities, which the calling application can compare with the local version to identify if anything has changed, and if so, request the changed external items to update the cached data.

This method can potentially return a lot of external items. IFilterCollection can be specified to filter the results and optimize the behavior. For more information about how to use filters, see IFilterCollection.

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.

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.

© 2015 Microsoft