MsmqBindingElementBase.CustomDeadLetterQueue Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets a Uri that identifies a custom dead-letter queue where expired messages or messages that failed to be delivered are sent.

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

[ConfigurationPropertyAttribute("customDeadLetterQueue", DefaultValue = null)]
public Uri CustomDeadLetterQueue { get; set; }

Property Value

Type: System.Uri

A Uri instance that contains the URI of the custom dead-letter-queue.

A 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 CustomDeadLetterQueue property allows you to specify a custom dead-letter queue rather than using the default system-wide, dead-letter queue.

The URI that is specified by CustomDeadLetterQueue must use the net.msmq scheme.

If DeadLetterQueue is set to None or System, then CustomDeadLetterQueue must be set to null. If CustomDeadLetterQueue is not null, then DeadLetterQueue must be set to Custom.

.NET Framework
Available since 3.0
Return to top