IEntity.FindAssociated método (EntityInstanceCollection, IAssociation, ILobSystemInstance, OperationMode)

Artigo
05/11/2016

Obtém os itens externos que estão associados com os itens externos de origem especificado usando o modo especificado de operação..

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

Sintaxe

'Declaração
Function FindAssociated ( _
    sourceEntityInstances As EntityInstanceCollection, _
    association As IAssociation, _
    lobSystemInstance As ILobSystemInstance, _
    mode As OperationMode _
) As IEntityInstanceEnumerator
'Uso
Dim instance As IEntity
Dim sourceEntityInstances As EntityInstanceCollection
Dim association As IAssociation
Dim lobSystemInstance As ILobSystemInstance
Dim mode As OperationMode
Dim returnValue As IEntityInstanceEnumerator

returnValue = instance.FindAssociated(sourceEntityInstances, _
    association, lobSystemInstance, _
    mode)

IEntityInstanceEnumerator FindAssociated(
    EntityInstanceCollection sourceEntityInstances,
    IAssociation association,
    ILobSystemInstance lobSystemInstance,
    OperationMode mode
)

Parâmetros

sourceEntityInstances
Tipo: Microsoft.BusinessData.Runtime.EntityInstanceCollection

As instâncias de origem.

association
Tipo: Microsoft.BusinessData.MetadataModel.IAssociation

A associação usar.

lobSystemInstance
Tipo: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

A instância do sistema externo.

mode
Tipo: Microsoft.BusinessData.Runtime.OperationMode

O modo de operação ler os itens externos.

Valor retornado

Tipo: Microsoft.BusinessData.Runtime.IEntityInstanceEnumerator
Um enumerador aos itens externos.

Comentários

A associação fornecida como entrada para este método deve ser um AssociationNavigator. FindAssociated requer um item externo para cada tipo de conteúdo externo de origem da AssociationNavigator e retornarão itens externos com base no tipo de conteúdo externo de destino da AssociationNavigator que estão associados os determinado itens externos.

Este método potencialmente pode retornar muitas itens externos. IFilterCollection pode ser especificado para filtrar os resultados e otimizar o comportamento. Para obter mais informações sobre como usar filtros, consulte IFilterCollection.

Esse método retorna um IEntityInstanceEnumerator, que exige especial limpar e pode expor funcionalidade adicional para controlar o comportamento quando o sistema externo retorna dados em lotes. Para obter mais informações sobre como usar enumeradores de item externo, consulte IEntityInstanceEnumerator.

O modo de operação pode ser especificado para este método. Para obter mais informações sobre como usar os modos de operação, consulte OperationMode.

Instâncias de objetos do modelo de objeto de conectividade de dados corporativos estão vinculadas no repositório de metadados que eles são obtidos. Usando instâncias vinculadas a um repositório de metadados com as instâncias do repositório de metadados outro causará corrupção de dados e outro comportamento inesperado. Para obter mais informações, consulte DatabaseBackedMetadataCatalog, FileBackedMetadataCataloge RemoteSharedFileBackedMetadataCatalog.