MsmqBindingBase.ExactlyOnce Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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
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.