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

Gets the external item with the given identity for a specific SpecificFinder MethodInstance object and a given OperationMode object, with an option to read the data immediately or read it on the first function call that requires a read.

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, _
    readNow As Boolean _
) As IEntityInstance
'Usage
Dim instance As IEntity
Dim identity As Identity
Dim specificFinderName As String
Dim lobSystemInstance As ILobSystemInstance
Dim mode As OperationMode
Dim readNow As Boolean
Dim returnValue As IEntityInstance

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

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

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.

• readNow
  Type: System.Boolean

  true to read the data immediately; otherwise, the data is read on the first function call that requires a read.

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.

See Also

Reference

IEntity Interface

IEntity Members

FindSpecific Overload

Microsoft.BusinessData.MetadataModel Namespace