Configuration Class

Specifies the service configuration settings for an eConnect application.

Constructor

Name

Description

Configuration()

Initializes an instance of the Configuration class.

Properties

Name

Type

Default

Description

LogDtcPromotions

bool

true

Specifies whether to log a warning when a transaction is promoted to a distributed transaction. This property is read-only. To change logging behavior, use the configuration file to set this property to false.

MaxReadQuotaSize

int

2147483647

Specifies the maximum size of read messages. The default value is the largest possible value.

MaxReceivedMessageSize

int

2147483647

Specifies the maximum size of an XML document. The default value is the largest possible value.

ProcTimeOut

int

600

Specifies the number of seconds to wait before a time out occurs

RequireProxyService

bool

true

Specifies whether to use the identify of the logged on user or the service identity when accessing SQL server. The value true forces the application to use the service identity.

ReuseBaseTransaction

bool

false

Specifies whether to reuse the base transaction for all new connection strings. Set the value to false to always use a new SQL connection.

If you set the value to true, you can reuse an existing SQL connection for different connection strings. However, reusing an existing connection causes the transaction to be promoted to a SQL Distributed Transaction Coordinator (DTC) transaction. A DTC transaction requires additional overhead that can slow the completion of the transaction.

SendTimeout

System.Timespan

60 minutes

Specifies the length of time to wait when connecting to the eConnect Integration Service. Used when the RequiredProxyService is set to true.

ServiceAddress

String

net.pipe://localhost/Microsoft/Dynamics/GP/eConnect/

Specifies the URL of the eConnect Integration Service.

ServiceOperationTimeout

System.Timespan

60 minutes

Specifies the length of time to wait for an operation to complete. Used when the RequiredProxyService is set to true.

TransactionIsolationLevel

System.Transaction.IsolationLevel

ReadUncommitted

Specifies the isolation level of the transaction.

TransactionTimeoutSeconds

System.Timespan

60 minutes

Specifies the length of time to wait for a SQL transaction to complete.

Remarks

These properties are typically populated with values from the application configuration file. However, you can also set or change these properties from your application. If you change a Configuration class property in your application code, the new value overrides the value specified in the configuration file.