Export (0) Print
Expand All

DefaultSettingsSection.DistributedTransactionManagerName Property

Gets the name of the transaction manager.

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

[ConfigurationPropertyAttribute("distributedTransactionManagerName", DefaultValue = "")]
public string DistributedTransactionManagerName { get; set; }

Property Value

Type: System.String
The name of the transaction manager. The default value is an empty string.

ExceptionCondition
NotSupportedException

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

TransactionAbortedException

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

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft