DefaultSettingsSection.DistributedTransactionManagerName プロパティ

.NET Framework クラス ライブラリ リファレンス

DefaultSettingsSection.DistributedTransactionManagerName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

トランザクション マネージャの名前を取得します。

名前空間: System.Transactions.Configuration
アセンブリ: System.Transactions (system.transactions.dll 内)
構文

Visual Basic (宣言)

Public Property DistributedTransactionManagerName
 As String

Visual Basic (使用法)

Dim instance As DefaultSettingsSection
Dim value As String

value = instance.DistributedTransactionManagerName

instance.DistributedTransactionManagerName = value

C#

public string DistributedTransactionManagerName
 { get; set; }

C++

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

J#

/** @property */
public String get_DistributedTransactionManagerName ()

/** @property */
public void set_DistributedTransactionManagerName
 (String value)

JScript

public function get DistributedTransactionManagerName
 () : String

public function set DistributedTransactionManagerName
 (value : String)

プロパティ値
トランザクション マネージャの名前。既定値は空の文字列です。

例外

例外の種類	条件
NotSupportedException	このプロパティを完全修飾ドメイン名または IP アドレスに設定しようとしました。
TransactionAbortedException	このプロパティを localhost に設定しようとしました。

解説

このプロパティは、Microsoft 分散トランザクション コーディネータ (MSDTC: Microsoft Distributed Transaction Coordinator) を実行し、ローカルで開始されるすべての分散トランザクションを調整する役割を持つコンピュータの名前を格納します。この名前では、大文字と小文字が区別されません。

このプロパティの値を設定して、System.Transactions に基づいてリモート トランザクション マネージャを有効にできます。このプロパティが null 参照 (Visual Basic では Nothing) である場合、または空の文字列を格納している場合は、ローカルのトランザクション マネージャがリモート トランザクション マネージャとして使用されます。このプロパティを既定の空の文字列以外に設定している場合は、Windows Server 2003 Service Pack 1 をインストールする必要があります。そうしないと、すべてのトランザクション操作は失敗し、NotSupportedException がスローされます。

このプロパティは、コンピュータの短い名前だけを格納している必要があります。完全修飾ドメイン名、ローカル ホスト アドレス、または IP アドレスは受け入れません。トランザクションの管理が MSDTC にエスカレートされた場合、ローカルの MSDTC は使用されません。代わりに、このプロパティで指定されたコンピュータの MSDTC が使用されます。何らかの理由でそのトランザクション マネージャを使用できない場合は、例外がスローされます。

リモートの MSDTC を使用するには、適切なセキュリティ アクセス許可が必要です。DTC のセキュリティ設定の構成方法の詳細については、「Configuring MSDTC security properties」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DefaultSettingsSection クラス
DefaultSettingsSection メンバ
System.Transactions.Configuration 名前空間