UseDeadLetterQueue Property (Message)

Gets or sets a value that indicates whether a copy of the message that could not be delivered should be sent to a dead-letter queue.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
<ReadOnlyAttribute(True)>
<DesignerSerializationVisibilityAttribute(DesignerSerializationVisibility.Hidden)>
<MessagingDescriptionAttribute("Specifies if a copy of the message should be sent to a dead-letter queue.")>
Public Property UseDeadLetterQueue As Boolean

'Usage
 
Dim instance As Message
Dim value As Boolean
 
instance.UseDeadLetterQueue = value
 
value = instance.UseDeadLetterQueue

[ReadOnly(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[MessagingDescription("Specifies if a copy of the message should be sent to a dead-letter queue.")]
public bool UseDeadLetterQueue {get; set;}

[ReadOnly(true)]
[DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
[MessagingDescription("Specifies if a copy of the message should be sent to a dead-letter queue.")]
public:
property bool UseDeadLetterQueue {
   bool get();
   void set (    bool value);
}

Property Value

true if message-delivery failure should result in a copy of the message being sent to a dead-letter queue; otherwise, false. The default is false.

Exceptions

Exception	Description
System.InvalidOperationException	The message queue is filtered to ignore the UseDeadLetterQueue property.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

Message Class
Message Members