MsmqElementBase.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 Boolean value that indicates whether messages processed by this binding will be received exactly once.
public:
property bool ExactlyOnce { bool get(); void set(bool value); };
[System.Configuration.ConfigurationProperty("exactlyOnce", DefaultValue=true)]
public bool ExactlyOnce { get; set; }
[<System.Configuration.ConfigurationProperty("exactlyOnce", DefaultValue=true)>]
member this.ExactlyOnce : bool with get, set
Public Property ExactlyOnce As Boolean
Property Value
true
if messages processed by this binding will be received exactly once; otherwise, false
. The default is true
.
- Attributes
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 only to a transactional queue.
ExactlyOnce, when set to true
, indicates that Message Queuing (also known as MSMQ) will ensure that a sent message is delivered to the receiving message queue once and only once, and 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 Message Queuing.