Message.UseJournalQueue プロパティ

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

Message.UseJournalQueue プロパティ

送信元のコンピュータの履歴にメッセージのコピーを保持するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseJournalQueue As
 Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.UseJournalQueue

instance.UseJournalQueue = value

C#

public bool UseJournalQueue { get;
 set; }

C++

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

J#

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

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

JScript

public function get UseJournalQueue
 () : boolean

public function set UseJournalQueue
 (value : boolean)

プロパティ値
メッセージが (送信元のコンピュータから次のサーバーに) 正常に送信された後に送信元コンピュータの履歴にメッセージのコピーを保持するように要求する場合は true。それ以外の場合は false。既定値は false です。

例外

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

解説

UseJournalQueue プロパティと UseDeadLetterQueue プロパティは、メッセージ キューによるメッセージの追跡方法を指定します。UseJournalQueue が true の場合は、メッセージ送信の各ステップにおいて送信元コンピュータの履歴にコピーが保持されます。

送信されるメッセージが履歴キューにコピーされるのは、送信先キューがリモート コンピュータ上にある場合だけです。送信先がローカル コンピュータ上の場合、メッセージはキューに直接送信されるため、履歴へのコピー保持を必要とする中間ステップはありません。

メッセージを履歴キューに格納する場合は、不要になったメッセージが削除されるように定期的に履歴キューを空にしてください。履歴キューに格納されたメッセージは、履歴キューが存在するコンピュータのクォータに影響します。コンピュータ クォータは管理者によって設定されます。

履歴キューまたは配信不能キューは作成しません。この 2 つのキューは、どちらもメッセージ キューによって生成されるシステム キューです。

使用例

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

C#

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

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

C++

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

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

J#

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

.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 プロパティ
UseTracing
MessageQueue.UseJournalQueue
MaximumJournalSize