MsmqElementBase.ExactlyOnce Property

Definition

Namespace:

System.ServiceModel.Configuration

Assembly:

System.ServiceModel.dll

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

Boolean

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

Attributes

ConfigurationPropertyAttribute

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.