This documentation is archived and is not being maintained.

MessagePropertyFilter.UseDeadLetterQueue Property

Gets or sets a value that indicates whether to retrieve Message.UseDeadLetterQueue property information when receiving or peeking a message.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

public bool UseDeadLetterQueue { get; set; }
/** @property */
public boolean get_UseDeadLetterQueue ()

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

public function get UseDeadLetterQueue () : boolean

public function set UseDeadLetterQueue (value : boolean)

Property Value

true to receive Message.UseDeadLetterQueue information; otherwise, false. The default is true.

The UseDeadLetterQueue property of the Message class specifies whether a copy of a message that could not be delivered should be sent to a dead-letter queue.

The following code example demonstrates the use of the UseDeadLetterQueue property.

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

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

  • Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0
Show: