NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

Message.Recoverable

Gets or sets a value indicating whether the message is guaranteed to be delivered in the event of a computer failure or network problem.

[Visual Basic]
Overridable Public Property Recoverable As Boolean
[C#]
public bool Recoverable {virtual get; virtual set;}
[C++]
public: __property virtual bool get_Recoverable();
public: __property virtual void set_Recoverable(bool);
[JScript]
public function get Recoverable() : Boolean;
public function set Recoverable(Boolean);

Property Value

true if the message is guaranteed delivery even if a computer fails while the message is en-route to the queue; false if delivery is not assured in the event of computer failure. The default is false.

Exceptions

Exception Type Condition
InvalidOperationException The message queue is filtered not to read the Recoverable property.

Remarks

Recoverable provides access to the Delivery property of the Message Queuing MSMQMessage object.

When Recoverable is true, delivery of a message is assured by storing the message locally until a successful forward has been achieved. In every hop along its route, the message is forwarded to the next hop or stored locally in a backup file until delivered. Because of this, throughput may be slower for a message for which Recoverable is true.

Recoverable should be set to true if your message is transactional.

See Also

Message Class | Message Members | System.Messaging Namespace | UseTracing