配信できなかったメッセージのコピーを配信不能キューに送信するかどうかを示す値を取得または設定します。
Public Property UseDeadLetterQueue As Boolean
[C#]
public bool UseDeadLetterQueue {get; set;}
[C++]
public: __property bool get_UseDeadLetterQueue();public: __property void set_UseDeadLetterQueue(bool);
[JScript]
public function get UseDeadLetterQueue() : Boolean;public function set UseDeadLetterQueue(Boolean);
プロパティ値
メッセージが配信できなかったときにそのメッセージのコピーを配信不能キューに送信する場合は true 。それ以外の場合は false 。既定値は false です。
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | フィルタ処理されたメッセージ キューが、 UseDeadLetterQueue プロパティを無視します。 |
解説
UseJournalQueue プロパティと UseDeadLetterQueue プロパティは、メッセージ キューによるメッセージの追跡方法を指定します。 UseDeadLetterQueue が true に設定されている場合、非トランザクション メッセージの配信に失敗すると、そのメッセージを配信できなかったコンピュータ上の非トランザクション配信不能キューにメッセージが送信されます。(配信が失敗する原因として、たとえばメッセージのタイマが切れることがあげられます)
トランザクション メッセージの配信に失敗した場合 (否定受信確認の場合および失敗の可能性がある場合)、メッセージ キューはメッセージを送信元マシン上のトランザクション配信不能キューに送信します。
メッセージを配信不能キューに格納する場合、不要になったメッセージが削除されるように定期的に配信不能キューを空にしてください。配信不能キューに格納されたメッセージは、配信不能キューが存在するコンピュータのサイズ クォータに影響します。コンピュータ クォータとは、メッセージの格納用としてコンピュータ全体に (1 つのキューにではなく) 割り当てられる合計サイズのことで、管理者によって設定されます。
メモ 履歴キューまたは配信不能キューは作成しません。この 2 つのキューは、どちらもメッセージ キューによって生成されるシステム キューです。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
Message クラス | Message メンバ | System.Messaging 名前空間 | UseJournalQueue | UseTracing