Share via

MsmqBindingElementBase.DeadLetterQueue Property


Gets or sets the DeadLetterQueue setting for this binding.

 property System::ServiceModel::DeadLetterQueue DeadLetterQueue { System::ServiceModel::DeadLetterQueue get(); void set(System::ServiceModel::DeadLetterQueue value); };
[System.Configuration.ConfigurationProperty("deadLetterQueue", DefaultValue=System.ServiceModel.DeadLetterQueue.System)]
public System.ServiceModel.DeadLetterQueue DeadLetterQueue { get; set; }
[<System.Configuration.ConfigurationProperty("deadLetterQueue", DefaultValue=System.ServiceModel.DeadLetterQueue.System)>]
member this.DeadLetterQueue : System.ServiceModel.DeadLetterQueue with get, set
Public Property DeadLetterQueue As DeadLetterQueue

Property Value

A DeadLetterQueue value that specifies which type of dead-letter queue to use, if any.



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 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.

Applies to