MsmqBindingBase.ExactlyOnce Property

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.dll

Gets or sets a value that indicates whether messages processed by this binding are received exactly once.

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

public bool ExactlyOnce { get; set; }

member this.ExactlyOnce : bool with get, set

Public Property ExactlyOnce As Boolean

Property Value

Boolean

true if messages processed by this binding are received exactly once; otherwise, false. The default is true.

Remarks

A message can be sent with or without assurances. An assurance enables an application to ensure that a sent message reached the receiving message queue, or if it did not, the application can determine this by reading the dead-letter queue.

Messages sent with ExactlyOnce set to true must be sent to a transactional queue only.

ExactlyOnce, when set to true, indicates that Message Queuing (MSMQ) ensures that a sent message is delivered to the receiving message queue once and only once. If delivery fails, the message is sent to the dead-letter queue.

For messages that require ExactlyOnce to be false, the DeadLetterQueue property defaults to null.

For messages that require ExactlyOnce to be true, the DeadLetterQueue property defaults to a transactional system-wide dead-letter queue in MSMQ.