MsmqBindingBase.ExactlyOnce Property

 
System_CAPS_noteNote

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

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

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

public bool ExactlyOnce { get; set; }

Property Value

Type: System.Boolean

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

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.

.NET Framework
Available since 3.0
Return to top
Show: