ISystemUtility.ExecuteStatic Method

Executes a MethodInstance against the given external system instance with given parameters.

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

Syntax

'Declaration
Sub ExecuteStatic ( _
    mi As IMethodInstance, _
    si As ILobSystemInstance, _
    args As Object(), _
    context As IExecutionContext _
)
'Usage
Dim instance As ISystemUtility
Dim mi As IMethodInstance
Dim si As ILobSystemInstance
Dim args As Object()
Dim context As IExecutionContext

instance.ExecuteStatic(mi, si, args, context)

void ExecuteStatic(
    IMethodInstance mi,
    ILobSystemInstance si,
    Object[] args,
    IExecutionContext context
)

Parameters

• mi
  Type: Microsoft.BusinessData.MetadataModel.IMethodInstance

  MethodInstance that is being executed.

• si
  Type: Microsoft.BusinessData.MetadataModel.ILobSystemInstance

  External system instance which the method instance is being executed against.

• args
  Type: []

  Parameters of the method. The size of the parameter array is equal to the number of parameter objects in the method, and the values are going to be passed in order. Out and return parameters will be a null reference (Nothing in Visual Basic).

• context
  Type: Microsoft.BusinessData.Runtime.IExecutionContext

  ExecutionContext where this execution is happening in. This value will be null if ExecutionContext is not created.

Remarks

This method is responsible for converting a generic invocation request to a call against the external system. The parameters for this method will be in the structure and the type described by the metadata. This method must set the return and output parameter values in the given array before returning on successful execution. If errors are detected by the connector, this method is expected to throw exceptions that are defined in Business Data Connectivity (BDC) service. When any other exception is detected, a new instance of the connector will be created. Otherwise, the same instance of the connector will be used for multiple executions. The implementation of this method must be thread safe.

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: Implementing a Custom Connector

See Also

Reference

ISystemUtility Interface

ISystemUtility Members

Microsoft.BusinessData.Runtime Namespace