MsmqBindingElementBase.ReceiveErrorHandling Property

Definition

Gets or sets an enumeration value that specifies how poison and messages that cannot be dispatched are handled.

[System.Configuration.ConfigurationProperty("receiveErrorHandling", DefaultValue=Mono.Cecil.CustomAttributeArgument)]
public System.ServiceModel.ReceiveErrorHandling ReceiveErrorHandling { get; set; }
Property Value

A ReceiveErrorHandling value that specifies how poison and messages that cannot be dispatched are handled.

Remarks

When this property is set to Fault, the listener is faulted and a ProtocolException (wrapping a MsmqPoisonMessageException) is traced and thrown. The message is left in the queue and must be removed in a manual way. The MsmqPoisonMessageException contains a MessageLookupId that can be used to identify and manually remove the message from the poison-message queue.

When this property is set to Drop, the offending message is simply dropped.

When this property is set to Reject, a negative acknowledgement is sent to the client and the message is removed from the poison-message queue. This option is available only on Message Queuing (MSMQ) 4.0.

When this property is set to Move, the message is moved to the final poison-message subqueue. This option is available only on Message Queuing (also known as MSMQ) 4.0.

Applies to