MessagePropertyFilter.UseDeadLetterQueue プロパティ

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

MessagePropertyFilter.UseDeadLetterQueue プロパティ

メッセージを受信またはピークするときに Message.UseDeadLetterQueue プロパティ情報を取得するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseDeadLetterQueue As
 Boolean

Visual Basic (使用法)

Dim instance As MessagePropertyFilter
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)

プロパティ値
Message.UseDeadLetterQueue 情報を受信する場合は true。それ以外の場合は false。既定値は true です。

解説

Message クラスの UseDeadLetterQueue プロパティは、配信できなかったメッセージのコピーを配信不能キューに送信するかどうかを指定します。

使用例

UseDeadLetterQueue プロパティの使用方法を示すコード例を次に示します。

C#

// Set the queue's MessageReadPropertyFilter property to enable the
// message's UseDeadLetterQueue property.
queue.MessageReadPropertyFilter.UseDeadLetterQueue = true;

// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0)); 

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

C++

// Set the queue's MessageReadPropertyFilter property 
// to enable the message's UseDeadLetterQueue property.
queue->MessageReadPropertyFilter->
    UseDeadLetterQueue = true;

// Peek at the message. Time out after ten seconds 
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));

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

J#

// Set the queue's MessageReadPropertyFilter property to enable the
// message's UseDeadLetterQueue property.
queue.get_MessageReadPropertyFilter().set_UseDeadLetterQueue(true);
// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));
// Display the 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

参照

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