Message.UseTracing プロパティ

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

Message.UseTracing プロパティ

メッセージが送信先キューに移動していく途中でメッセージをトレースするかどうかを示す値を取得または設定します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property UseTracing As
 Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.UseTracing

instance.UseTracing = value

C#

public bool UseTracing { get;
 set; }

C++

public:
property bool UseTracing {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_UseTracing ()

/** @property */
public void set_UseTracing (boolean value)

JScript

public function get UseTracing
 () : boolean

public function set UseTracing
 (value : boolean)

プロパティ値
元のメッセージが送信先キューに到達するまでに発生する各中間ステップごとにレポートを生成してシステムのレポート キューに送信させる場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、UseTracing プロパティを無視します。

解説

UseTracing プロパティは、メッセージが送信先のキューへと移動していく経路を追跡するかどうかを指定します。true の場合は、メッセージがメッセージ キューのルーティング サーバーを通過するたびに、レポート メッセージ (メッセージ キューによって生成される) がレポート キューに送信されます。レポート キューは、送信元キュー マネージャによって指定されます。レポート キューには、メッセージ キューによって生成されるレポート メッセージだけでなく、アプリケーションによって生成されるメッセージも送信できます。

トレースを使用するには、Active Directory を設定し、メッセージ キュー エンタープライズのレポート キューを指定する必要があります。これらの設定は管理者が行います。

使用例

メッセージの UseTracing プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// Set the message's UseTracing property to true.
orderMessage.UseTracing = true;

// Display the new value of the message's UseTracing property.
Console.WriteLine("Message.UseTracing: {0}", orderMessage.UseTracing);

C++

// Set the message's UseTracing property to true.
orderMessage->UseTracing = true;

// Display the new value of the message's UseTracing property.
Console::WriteLine("Message.UseTracing: {0}", orderMessage->UseTracing);

J#

// Set the message's UseTracing property to true.
orderMessage.set_UseTracing(true);
// Display the new value of the message's UseTracing property.
Console.WriteLine("Message.UseTracing: {0}", 
    System.Convert.ToString(orderMessage.get_UseTracing()));

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.UseDeadLetterQueue プロパティ
Message.UseJournalQueue プロパティ