ISynchronizationManager.PopulateCache Method (IEntity, IFilterCollection, String, ILobSystemInstance)

Gets the External Items and populates the cache using the specified external content type, collection of filters, finder method name, and external system instance.

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

Syntax

'Declaration
Sub PopulateCache ( _
    thisEntity As IEntity, _
    filterCollection As IFilterCollection, _
    finderName As String, _
    lobSystemInstance As ILobSystemInstance _
)
'Usage
Dim instance As ISynchronizationManager
Dim thisEntity As IEntity
Dim filterCollection As IFilterCollection
Dim finderName As String
Dim lobSystemInstance As ILobSystemInstance

instance.PopulateCache(thisEntity, filterCollection, _
    finderName, lobSystemInstance)

void PopulateCache(
    IEntity thisEntity,
    IFilterCollection filterCollection,
    string finderName,
    ILobSystemInstance lobSystemInstance
)

Parameters

• thisEntity
  Type: Microsoft.BusinessData.MetadataModel.IEntity

  The external content type to populate.

• filterCollection
  Type: Microsoft.BusinessData.Runtime.IFilterCollection

  The filters to apply.

• finderName
  Type: System.String

  The name of the finder to execute.

• lobSystemInstance
  Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  The external system instance.

Remarks

This method invokes the Finder method. If the view of the Finder method does not match the view of the corresponding SpecificFinder method, then the SpecificFinder methods need to be invoked for all the external content type instances returned by the Finder so that all the view data is available. The SpecificFinder method invocations do not happen immediately.

An exception is thrown if the operation cannot be completed.

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.

See Also

Reference

ISynchronizationManager Interface

ISynchronizationManager Members

PopulateCache Overload

Microsoft.BusinessData.Offlining Namespace

Other Resources

Stereotyped Operations Supported by BDC