MessageQueue.UseJournalQueue プロパティ

定義

受信したメッセージを履歴キューにコピーするかどうかを示す値を取得または設定します。

public:
 property bool UseJournalQueue { bool get(); void set(bool value); };
[System.Messaging.MessagingDescription("MQ_UseJournalQueue")]
public bool UseJournalQueue { get; set; }
[<System.Messaging.MessagingDescription("MQ_UseJournalQueue")>]
member this.UseJournalQueue : bool with get, set
Public Property UseJournalQueue As Boolean

プロパティ値

キューから受信したメッセージを履歴キューにコピーする場合は true。それ以外の場合は false

属性

例外

メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

次のコード例では、メッセージ キュー UseJournalQueue の プロパティの値を取得および設定します。

// Set the queue's UseJournalQueue property value.
queue.UseJournalQueue = true;

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

注釈

メッセージ キュー アプリケーションは、新しいアプリケーション キューを作成すると、関連付けられたジャーナル キューを同じ場所に自動的に作成します。 ジャーナル キューは、キューから削除されたメッセージを追跡するために使用されます。 このプロパティを設定すると、メッセージ キュー キューが変更されます。 そのため、その他 MessageQueue のインスタンスは変更の影響を受けます。

ジャーナル キューは、受信までの時間のタイマーが期限切れになったためにキューから削除されたメッセージを追跡したり、メッセージ キュー ディレクトリ サービス (Information Store または Active Directory) を使用してキューから消去されたメッセージを追跡したりしません。

アプリケーションはジャーナル キューにメッセージを送信できません。これらのキューの読み取り専用アクセスに制限されます。 さらに、メッセージ キューによってジャーナル キューからメッセージが削除されることはありません。 キューを使用するアプリケーションは、メッセージを受信するかキューを消去することによって、これらのメッセージをクリアする必要があります。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード 利用可能
ローカル コンピューター はい
ローカル コンピューターと直接の形式名 はい
リモート コンピューター いいえ
リモート コンピューターと直接形式の名前 いいえ

適用対象

こちらもご覧ください