Message.UseJournalQueue プロパティとは何？わかりやすく解説 Weblio辞書

.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

public bool UseJournalQueue { get;
 set; }

C++

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

/** @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 プロパティに対し、値の取得と設定を行うコード例を次に示します。

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

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