Export (0) Print
Expand All

MsmqBindingElementBase.DeadLetterQueue Property

Gets or sets the DeadLetterQueue setting for this binding.

Namespace:  System.ServiceModel.Channels
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

public DeadLetterQueue DeadLetterQueue { get; set; }

Property Value

Type: System.ServiceModel.DeadLetterQueue
The type of dead-letter queue to use, if any.

ExceptionCondition
ArgumentOutOfRangeException

The value is not within the range of values defined in DeadLetterQueue.

The dead-letter queue is a queue managed by the sending application's queue manager that stores messages that have failed to be delivered or have expired. The reasons that a message can fail to reach the receiving application include:

  • A transactional message is sent to a non-transactional queue.

  • A non-transactional message is sent to a transactional queue.

  • An unauthenticated message is sent to a queue that accepts only authenticated messages.

  • An unencrypted message is sent to a queue that accepts only encrypted messages.

  • The message expires before the message is delivered to a receiver.

  • The message storage quota of the target computer or the storage quota of the destination queue is exceeded, or there is no available storage space on the target computer when the message arrives.

  • The sender does not have the access rights required to place the message in the destination queue.

  • The digital signature attached to the message is not valid.

  • An encrypted message cannot be decrypted by the destination queue manager.

  • The destination queue is purged or deleted before the message is retrieved.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft