DefaultSettingsSection.DistributedTransactionManagerName Property

Definition

Namespace:

System.Transactions.Configuration

Assembly:

System.Transactions.dll

Gets the name of the transaction manager.

public:
 property System::String ^ DistributedTransactionManagerName { System::String ^ get(); void set(System::String ^ value); };

[System.Configuration.ConfigurationProperty("distributedTransactionManagerName", DefaultValue="")]
public string DistributedTransactionManagerName { get; set; }

[<System.Configuration.ConfigurationProperty("distributedTransactionManagerName", DefaultValue="")>]
member this.DistributedTransactionManagerName : string with get, set

Public Property DistributedTransactionManagerName As String

Property Value

String

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

Attributes

ConfigurationPropertyAttribute

Exceptions

NotSupportedException

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

TransactionAbortedException

An attempt to set this property to localhost.

Remarks

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 article.