Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

MsmqBindingElementBase::DeadLetterQueue Property

 

Gets or sets the DeadLetterQueue setting for this binding.

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

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

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:
© 2017 Microsoft