IEntity.FindSpecific Method (Identity, String, ILobSystemInstance, Boolean)
Gets the external item with the given identity for a specific SpecificFinder MethodInstance object and a given LobSystem instance, 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, _
readNow As Boolean _
) As IEntityInstance
'Usage
Dim instance As IEntity
Dim identity As Identity
Dim specificFinderName As String
Dim lobSystemInstance As ILobSystemInstance
Dim readNow As Boolean
Dim returnValue As IEntityInstance
returnValue = instance.FindSpecific(identity, _
specificFinderName, lobSystemInstance, _
readNow)
IEntityInstance FindSpecific(
Identity identity,
string specificFinderName,
ILobSystemInstance lobSystemInstance,
bool readNow
)
Parameters
identity
Type: Microsoft.BusinessData.Runtime.IdentityThe identity of the external item.
specificFinderName
Type: System.StringThe name of the SpecificFinder .
lobSystemInstance
Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstanceThe external system instance.
readNow
Type: System.Booleantrue 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.