MsmqBindingElementBase.DeadLetterQueue Property

Definition

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Gets or sets the DeadLetterQueue setting for this binding.

public:
 property System::ServiceModel::DeadLetterQueue DeadLetterQueue { System::ServiceModel::DeadLetterQueue get(); void set(System::ServiceModel::DeadLetterQueue value); };

public System.ServiceModel.DeadLetterQueue DeadLetterQueue { get; set; }

member this.DeadLetterQueue : System.ServiceModel.DeadLetterQueue with get, set

Public Property DeadLetterQueue As DeadLetterQueue

Property Value

DeadLetterQueue

The type of dead-letter queue to use, if any.

Exceptions

ArgumentOutOfRangeException

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

Remarks

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.