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.

Exception Condition
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
Available since 3.0
Return to top
Show: