IEntity.FindSpecific Method (Identity, String, ILobSystemInstance, OperationMode)

Gets the external item with the given identity for a specific SpecificFinder MethodInstance object with the given OperationMode object.

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

Syntax

'Declaration
Function FindSpecific ( _
    identity As Identity, _
    specificFinderName As String, _
    lobSystemInstance As ILobSystemInstance, _
    mode As OperationMode _
) As IEntityInstance
'Usage
Dim instance As IEntity
Dim identity As Identity
Dim specificFinderName As String
Dim lobSystemInstance As ILobSystemInstance
Dim mode As OperationMode
Dim returnValue As IEntityInstance

returnValue = instance.FindSpecific(identity, _
    specificFinderName, lobSystemInstance, _
    mode)

IEntityInstance FindSpecific(
    Identity identity,
    string specificFinderName,
    ILobSystemInstance lobSystemInstance,
    OperationMode mode
)

Parameters

• identity
  Type: Microsoft.BusinessData.Runtime.Identity

  The identity of the external item.

• specificFinderName
  Type: System.String

  The name of the SpecificFinder MethodInstance object.

• lobSystemInstance
  Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  The external system instance.

• mode
  Type: Microsoft.BusinessData.Runtime.OperationMode

  The OperationMode object to read the external items.

Return Value

Type: Microsoft.BusinessData.Runtime.IEntityInstance
An external item.

Remarks

This method throws an ObjectNotFoundException if the item is not found on the external system.

The mode of operation can be specified for this method. For more information about how to use operation modes, see OperationMode.

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.

Examples

Code Snippet: Execute the AssociationNavigator Method Instance of an External Content Type for an Association Without a Foreign Key

Code Snippet: Execute the Associator and Disassociator Method Instances of an External Content Type

Code Snippet: Execute the BulkAssociationNavigator Method Instance of an External Content Type

See Also

Reference

IEntity Interface

IEntity Members

FindSpecific Overload

Microsoft.BusinessData.MetadataModel Namespace