---
schema_version: "1"
id: f0bafc8c3d82234431de1548e334b1f3c632758aade4243f397a6bf26e0d115a
title: Microsoft .NET Connector 3.1 Reference
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/microsoft-dotnet-connector/latest/microsoft-dotnet-connector-reference.md
canonical_url: https://docs.mulesoft.com/microsoft-dotnet-connector/latest/microsoft-dotnet-connector-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: bee3bbc69db1831dd3ea62142c4fde09823bc4d2a89655df39e339abbfb490e9
description: MuleSoft Documentation Site
release: "3.1"
latest: true
---
---
product: Microsoft .NET Connector
version: 3.1
is-latest-version: true
---

# Microsoft .NET Connector 3.1 Reference

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

## Default Configuration

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Name</p></td><td><p>String</p></td><td><p>The name for this configuration. Connectors reference the configuration with this name.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Connection</p></td><td><div><div><ul><li><p><a href="#dot-net-config_external">External</a></p></li><li><p><a href="#dot-net-config_gac">GAC</a></p></li><li><p><a href="#dot-net-config_legacy">Legacy</a></p></li><li><p><a href="#dot-net-config_resource">Resource</a></p></li></ul></div></div></td><td><p>The connection types that can be provided to this configuration.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Expiration Policy</p></td><td><div><div><p><a href="#ExpirationPolicy">Expiration Policy</a></p></div></div></td><td><p>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 that it becomes eligible. Mule purges the instances as appropriate.</p></td><td></td><td></td></tr></tbody></table>

## External Connection Type

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Scope</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>Singleton</p></li><li><p>Transient</p></li></ul></div></div></td><td><p>The scope of the module</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Grant Full Trust to the .NET assembly</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Full Trust</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Declared methods only</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Declared Only</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Include auto generated code</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Include Auto Generated Code.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of the .NET assembly, for example, <code>&lt;Company&gt;.&lt;Component&gt;.dll</code></p></td><td></td><td><p>x</p></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to <code>true</code>, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

## GAC Connection Type

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Scope</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>Singleton</p></li><li><p>Transient</p></li></ul></div></div></td><td><p>Provide the scope of the module</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Grant Full Trust to the .NET assembly</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Full Trust.</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Declared methods only</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Declared Only.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Include auto generated code</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Include Auto Generated Code</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Assembly Type</p></td><td><div><div><p>String</p></div></div></td><td><p>Provide the Fully Qualified Type name, for example, <code>Namespace.ClassName</code>.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to <code>true</code>, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

## Legacy Connection Type

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Scope</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>Singleton</p></li><li><p>Transient</p></li></ul></div></div></td><td><p>The scope of the module</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Grant Full Trust to the .NET assembly</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Full Trust.</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Declared methods only</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Declared Only.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Include auto generated code</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Include Auto Generated Code.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Assembly Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The fully qualified type name, for example, <code>Namespace.ClassName</code></p></td><td></td><td></td></tr><tr><td><p>Assembly Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path of the .NET assembly, for example, <code>C:\Projects\&lt;Company&gt;.&lt;Component&gt;.dll</code></p></td><td></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to <code>true</code>, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

## Resource Connection Type

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Scope</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>Singleton</p></li><li><p>Transient</p></li></ul></div></div></td><td><p>The scope of the module</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Grant Full Trust to the .NET assembly</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Full Trust.</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Declared methods only</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Declared Only</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Include auto generated code</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Set Include Auto Generated Code.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of the .NET assembly, for example, <code>&lt;Company&gt;.&lt;Component&gt;.dll</code></p></td><td></td><td><p>x</p></td></tr><tr><td><p>Resource folder</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of the resource folder</p></td><td></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to <code>true</code>, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

## Operations

- [Execute](#execute)

## Execute

`<dotnet:execute>`

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

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Arguments</p></td><td><div><div><p>Object</p></div></div></td><td><p>The arguments to pass to the called method.</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Type</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Method</p></td><td><div><div><p>String</p></div></div></td><td></td><td></td><td><p>x</p></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of a variable in which to store the operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression that evaluates the operation’s output. The expression outcome is stored in the target variable.</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr></tbody></table>

### For Configurations

- [Default Configuration](#dot-net-config)

### Throws

- DOTNET:LOADER

- DOTNET:REQUEST

- DOTNET:METADATA

- DOTNET:UNKNOWN

- DOTNET:RETRY\_EXHAUSTED

- DOTNET:CONNECTIVITY

## Types

### Reconnection

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Fails Deployment</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to <code>true</code>, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#reconnect">Reconnect</a></p></li><li><p><a href="#reconnect-forever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>The reconnection strategy to use.</p></td><td></td><td></td></tr></tbody></table>

### Reconnect

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Frequency</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How often to reconnect (in milliseconds).</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Count</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The number of reconnection attempts to make.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Reconnect Forever

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Frequency</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How often in milliseconds to reconnect.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Expiration Policy

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Max Idle Time</p></td><td><div><div><p>Number</p></div></div></td><td><p>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.</p></td><td></td><td></td></tr><tr><td><p>Time Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Max IdleTime field.</p></td><td></td><td></td></tr></tbody></table>

## See Also

- [Introduction to Anypoint Connectors](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)

- [Salesforce Help](https://help.salesforce.com)