DefaultSettingsSection.DistributedTransactionManagerName Propriété

Définition

Espace de noms:

System.Transactions.Configuration

Assembly:

System.Transactions.dll

Obtient le nom du gestionnaire de transactions.

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

Valeur de propriété

String

Nom du gestionnaire de transactions. La valeur par défaut est une chaîne vide.

Attributs

ConfigurationPropertyAttribute

Exceptions

NotSupportedException

Tentative d'affectation de noms de domaines complets ou d'adresses IP à cette propriété.

TransactionAbortedException

Tentative d'affectation de localhost à cette propriété.

Remarques

Cette propriété contient le nom de l’ordinateur qui exécute Microsoft Distributed Transaction Coordinator (MSDTC) et est responsable de la coordination de toutes les transactions distribuées démarrées localement.

Vous pouvez définir la valeur de cette propriété pour activer les gestionnaires de transactions distants sous System.Transactions. Si cette propriété est null ou contient une chaîne vide, le gestionnaire de transactions local est utilisé comme gestionnaire de transactions distant. Si vous définissez cette propriété sur une valeur autre que la chaîne vide par défaut, vous devez installer Windows Server 2003 Service Pack 1. Sinon, toute opération transactionnelle échoue avec NotSupportedException. Une transaction qui est réaffectée pour être gérée par le MSDTC n’utilise pas le MSDTC local, mais utilise plutôt celui sur l’ordinateur spécifié par cette propriété. Si ce gestionnaire de transactions n’est pas disponible pour une raison quelconque, une exception est levée.

Cette propriété ne respecte pas la casse et doit uniquement contenir le nom court de l’ordinateur. Il n’accepte pas les noms de domaine complets, les adresses IP ou localhost. Si cette propriété contient un nom de machine distante non valide, une exception « impossible de lire les informations de configuration » est levée.

Vous devez disposer de l’autorisation de sécurité appropriée pour utiliser un MSDTC distant. Pour plus d’informations sur la configuration des paramètres de sécurité DTC, consultez l’article Configuration des propriétés de sécurité MSDTC .