DefaultSettingsSection.DistributedTransactionManagerName Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets the name of the transaction manager.

Namespace:   System.Transactions.Configuration
Assembly:  System.Transactions (in System.Transactions.dll)

	DefaultValue = "")]
public string DistributedTransactionManagerName { get; set; }

Property Value

Type: System.String

The name of the transaction manager. The default value is an empty string.

Exception Condition

An attempt to set this property to fully qualified domain names or IP addresses.


An attempt to set this property to localhost.

This property contains the name of the computer which is running the Microsoft Distributed Transaction Coordinator (MSDTC) and is responsible for coordinating all distributed transactions started locally.

You can set the value of this property to enable remote transaction managers under System.Transactions. If this property is null or contains an empty string, the local transaction manager is used as the remote transaction manager. If you set this property to a value other than the default empty string, you must install Windows Server 2003 Service Pack 1. Otherwise, any transactional operation fails with NotSupportedException. A transaction that is escalated to be managed by the MSDTC will not use the local MSDTC, but instead use the one on the machine specified by this property. If that transaction manager is unavailable for any reason, an exception is thrown.

This property is not case-sensitive, and should only contain the short name of the machine. It does not accept fully qualified domain names, localhost or IP addresses. If this property contains an invalid remote machine name, an "unable to read configuration information" exception is thrown.

You should have the proper security permission to use a remote MSDTC. For more information on how to configure DTC security settings, please see the Configuring MSDTC security properties topic.

.NET Framework
Available since 2.0
Return to top