MessageQueue.UseJournalQueue プロパティ

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

MessageQueue.UseJournalQueue プロパティ

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

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

Visual Basic (宣言)

Public Property UseJournalQueue As
 Boolean

Visual Basic (使用法)

Dim instance As MessageQueue
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。

例外

例外の種類	条件
MessageQueueException	メッセージ キューのメソッドにアクセスしたときにエラーが発生しました。

解説

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

履歴キューは、受信制限時間が経過したためにキューから削除されたメッセージは追跡しません。メッセージ キュー ディレクトリ サービス (インフォメーション ストアまたは Active Directory) を使用してキューからパージされたメッセージも追跡しません。

アプリケーションはメッセージを履歴キューに送信できません。履歴キューは読み取りアクセス専用です。さらに、メッセージ キューは履歴キューのメッセージを削除しません。キューを使用するアプリケーションは、これらのメッセージを受信するか、キューをパージする必要があります。

このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	○
ローカル コンピュータと直接書式名	○
リモート コンピュータ	×
リモート コンピュータと直接書式名	×

使用例

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

C#

// 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);

J#

// Set the queue's UseJournalQueue property value.
queue.set_UseJournalQueue(true);
// Display the new value of the queue's UseJournalQueue property.
Console.WriteLine("MessageQueue.UseJournalQueue: {0}", 
    System.Convert.ToString(queue.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

参照

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