Message.UseDeadLetterQueue プロパティ

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

Message.UseDeadLetterQueue プロパティ

配信できなかったメッセージのコピーを配信不能キューに送信するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseDeadLetterQueue As
 Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.UseDeadLetterQueue

instance.UseDeadLetterQueue = value

C#

public bool UseDeadLetterQueue { get;
 set; }

C++

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

J#

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

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

JScript

public function get UseDeadLetterQueue
 () : boolean

public function set UseDeadLetterQueue
 (value : boolean)

プロパティ値
メッセージが配信できなかったときにそのメッセージのコピーを配信不能キューに送信する場合は true。それ以外の場合は false。既定値は false です。

例外

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

解説

UseJournalQueue プロパティと UseDeadLetterQueue プロパティは、メッセージ キューによるメッセージの追跡方法を指定します。UseDeadLetterQueue が true に設定されている場合、非トランザクション メッセージの配信に失敗すると、そのメッセージを配信できなかったコンピュータ上の非トランザクション配信不能キューにメッセージが送信されます。配信が失敗する原因としては、メッセージのタイマが切れた場合などがあります。

トランザクション メッセージの配信に失敗した場合 (否定受信確認の場合および失敗の可能性がある場合)、メッセージ キューはメッセージを送信元マシン上のトランザクション配信不能キューに送信します。

メッセージを配信不能キューに格納する場合、不要になったメッセージが削除されるように定期的に配信不能キューを空にしてください。配信不能キューに格納されたメッセージは、配信不能キューが存在するコンピュータのサイズ クォータに影響します。コンピュータ クォータとは、メッセージの格納用としてコンピュータ全体に (1 つのキューにではなく) 割り当てられる合計サイズのことで、管理者によって設定されます。

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

使用例

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

C#

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

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

C++

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

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

J#

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

.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 名前空間
UseJournalQueue
UseTracing