Contact Us 1-800-596-4880

Microsoft .NET Connector Reference - Mule 4

Microsoft .NET Connector v3.0

This connector is compatible only with Java 8.

Default Configuration

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types that can be provided to this configuration.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before the runtime considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment it becomes eligible. The runtime only purges instances as needed.

External Connection Type

Parameters

Name Type Description Default Value Required

Scope

Enumeration, one of:

  • Singleton

  • Transient

Provide the scope of the module

x

Grant Full Trust to the .NET assembly

Boolean

Set Full Trust

true

Declared methods only

Boolean

Set Declared Only

false

Include auto generated code

Boolean

Set Include Auto Generated Code

false

Path

String

Provide the name of the .NET assembly for example, <Company>.<Component>.dll

x

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy

GAC Connection Type

Parameters

Name Type Description Default Value Required

Scope

Enumeration, one of:

  • Singleton

  • Transient

Provide the scope of the module

x

Grant Full Trust to the .NET assembly

Boolean

Set Full Trust

true

Declared methods only

Boolean

Set Declared Only

false

Include auto generated code

Boolean

Set Include Auto Generated Code

false

Assembly Type

String

Provide the Fully Qualified Type name for example, Namespace.ClassName

x

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy

Legacy Connection Type

Parameters

Name Type Description Default Value Required

Scope

Enumeration, one of:

  • Singleton

  • Transient

Provide the scope of the module

x

Grant Full Trust to the .NET assembly

Boolean

Set Full Trust

true

Declared methods only

Boolean

Set Declared Only

false

Include auto generated code

Boolean

Set Include Auto Generated Code

false

Assembly Type

String

Provide the fully qualified type name for example, Namespace.ClassName

Assembly Path

String

Provide the path of the .NET assembly for example, C:\Projects\<Company>.<Component>.dll

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Resource Connection Type

Parameters

Name Type Description Default Value Required

Scope

Enumeration, one of:

  • Singleton

  • Transient

Provide the scope of the module

x

Grant Full Trust to the .NET assembly

Boolean

Set Full Trust

true

Declared methods only

Boolean

Set Declared Only

false

Include auto generated code

Boolean

Set Include Auto Generated Code

false

Path

String

Provide the name of the .NET assembly for example, <Company>.<Component>.dll

x

Resource folder

String

The name of the resource folder

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Associated Operations

Execute

<dotnet:execute>

Returns an object that represents the return value of the invoked method.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Arguments

Object

the arguments to be passed to the called method.

#[payload]

Type

String

x

Method

String

x

Target Variable

String

The name of a variable in which the operation’s output is placed.

Target Value

String

An expression to evaluate against the operation’s output and the outcome of that expression is stored in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors

Output

Type

Any

For Configurations

Throws

  • DOTNET:LOADER

  • DOTNET:REQUEST

  • DOTNET:METADATA

  • DOTNET:UNKNOWN

  • DOTNET:RETRY_EXHAUSTED

  • DOTNET:CONNECTIVITY

Types

Reconnection

Field Type Description Default Value Required

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

The reconnection strategy to use.

Reconnect

Field Type Description Default Value Required

Frequency

Number

How often to reconnect (in milliseconds).

Count

Number

The number of reconnection attempts to make.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Reconnect Forever

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Expiration Policy

Field Type Description Default Value Required

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the maxIdleTime attribute.

View on GitHub