MsmqBindingElementBase.ReceiveErrorHandling Propriété

Définition

Obtient ou définit une valeur d'énumération qui spécifie la façon dont les messages incohérents ou ne pouvant pas être distribués sont gérés.Gets or sets an enumeration value that specifies how poison and other messages that cannot be dispatched are handled.

public:
 property System::ServiceModel::ReceiveErrorHandling ReceiveErrorHandling { System::ServiceModel::ReceiveErrorHandling get(); void set(System::ServiceModel::ReceiveErrorHandling value); };
public System.ServiceModel.ReceiveErrorHandling ReceiveErrorHandling { get; set; }
member this.ReceiveErrorHandling : System.ServiceModel.ReceiveErrorHandling with get, set
Public Property ReceiveErrorHandling As ReceiveErrorHandling

Valeur de propriété

Valeur ReceiveErrorHandling qui spécifie la manière dont les messages incohérents et d'autres messages qui ne peuvent pas être distribués sont gérés.A ReceiveErrorHandling value that specifies how poison and other messages that cannot be dispatched are handled.

Exceptions

La valeur n'est pas comprise dans la plage de valeurs définie dans l'objet ReceiveErrorHandling.The value is not within the range of values defined in ReceiveErrorHandling.

Remarques

Lorsque cette propriété a la valeur Fault, l'écouteur de canal provoque une erreur et une exception ProtocolException (encapsulant une exception MsmqPoisonMessageException) est suivie et levée.When this property is set to Fault, the channel listener is faulted and a ProtocolException (wrapping a MsmqPoisonMessageException) is traced and thrown. Le message est conservé dans la file d'attente et doit être supprimé manuellement.The message is left in the queue and must be removed by some manual method. L'exception MsmqPoisonMessageException contient une exception MessageLookupId qui peut être utilisée pour identifier et supprimer manuellement le message incriminé de la file d'attente des messages incohérents.The MsmqPoisonMessageException contains a MessageLookupId that can be used to identify and manually remove the offending message from the poison-message queue.

Lorsque cette propriété a la valeur Drop, le message est supprimé.When this property is set to Drop, the message is dropped.

Lorsque cette propriété a la valeur Reject, un accusé de réception négatif est envoyé au client et le message incriminé est supprimé de la file d'attente des messages incohérents.When this property is set to Reject, a negative acknowledgment is sent to the client and the message is removed from the poison-message queue. Cette option est uniquement disponible sur Message Queuing 4.0.This option is available only on Message Queuing 4.0.

S'il possède la valeur Move, le message est déplacé vers la sous-file d'attente finale des messages incohérents.When set to Move, the message is moved to the final poison sub-queue. Cette option est uniquement disponible sur Message Queuing 4.0.This option is available only on Message Queuing 4.0.

S’applique à