IEntityInstance.GetAssociatedInstances Method (IAssociation, OperationMode)

Gets the External Items associated with the given association, using the given operation mode.

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

Syntax

'Declaration
Function GetAssociatedInstances ( _
    association As IAssociation, _
    mode As OperationMode _
) As IEntityInstanceEnumerator
'Usage
Dim instance As IEntityInstance
Dim association As IAssociation
Dim mode As OperationMode
Dim returnValue As IEntityInstanceEnumerator

returnValue = instance.GetAssociatedInstances(association, _
    mode)

IEntityInstanceEnumerator GetAssociatedInstances(
    IAssociation association,
    OperationMode mode
)

Parameters

• association
  Type: Microsoft.BusinessData.MetadataModel.IAssociation

  The association to get the External Items for.

• mode
  Type: Microsoft.BusinessData.Runtime.OperationMode

  The operation mode to use.

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.

See Also

Reference

IEntityInstance Interface

IEntityInstance Members

GetAssociatedInstances Overload

Microsoft.BusinessData.Runtime Namespace