IEntityInstance.Disassociate Method (IEntityInstance, IAssociation)

Removes the association between this External Item and the given External Item by using the given association

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

Syntax

'Declaration
Sub Disassociate ( _
    instance As IEntityInstance, _
    association As IAssociation _
)
'Usage
Dim instance As IEntityInstance
Dim instance As IEntityInstance
Dim association As IAssociation

instance.Disassociate(instance, association)

void Disassociate(
    IEntityInstance instance,
    IAssociation association
)

Parameters

• instance
  Type: Microsoft.BusinessData.Runtime.IEntityInstance

  The External Item to remove association from this External Item.

• association
  Type: Microsoft.BusinessData.MetadataModel.IAssociation

  The association. The given association must have a single source external content type

Remarks

This method will reset the foreign identifier values on the External Item for the given association to their default values. To submit the change to the external system, Update method must be called. This method can only be used with foreign key based associations. For associations without a foreign key, use Disassociate() method. The given association must be a Disassociator or it must be in an AssociationGroup which contains a Disassociator.

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

Disassociate Overload

Microsoft.BusinessData.Runtime Namespace