IEntityInstance.GetAssociatedInstances Method (IAssociation, IFilterCollection)
Gets the External Items associated with the given association, using given filters.
Namespace: Microsoft.BusinessData.Runtime
Assembly: Microsoft.BusinessData (in Microsoft.BusinessData.dll)
Syntax
'Declaration
Function GetAssociatedInstances ( _
association As IAssociation, _
filters As IFilterCollection _
) As IEntityInstanceEnumerator
'Usage
Dim instance As IEntityInstance
Dim association As IAssociation
Dim filters As IFilterCollection
Dim returnValue As IEntityInstanceEnumerator
returnValue = instance.GetAssociatedInstances(association, _
filters)
IEntityInstanceEnumerator GetAssociatedInstances(
IAssociation association,
IFilterCollection filters
)
Parameters
association
Type: Microsoft.BusinessData.MetadataModel.IAssociationThe association to get the External Items for.
filters
Type: Microsoft.BusinessData.Runtime.IFilterCollectionThe filters to be applied to the given association.
Return Value
Type: Microsoft.BusinessData.Runtime.IEntityInstanceEnumerator
The associated External Items.
Remarks
This method will get the External Items of destination external content type of the association by providing this External Item as input. This method only works for Associations that have a single source external content type. The association must be an AssociationNavigator.
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.