Recoverable Property

Message.Recoverable Property

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

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

public bool Recoverable { get; set; }
/** @property */
public boolean get_Recoverable ()

/** @property */
public void set_Recoverable (boolean value)

public function get Recoverable () : boolean

public function set Recoverable (value : boolean)

Not applicable.

Property Value

true if delivery of the message is guaranteed (through saving the message to disk while en route); false if delivery is not assured. The default is false.

Exception typeCondition

InvalidOperationException

The message queue is filtered to ignore the Recoverable property.

The Recoverable property indicates whether the delivery of a message is guaranteed—even if a computer crashes while the message is en route to the destination queue.

If delivery of a message is guaranteed, the message is stored locally at every step along the route, until the message is successfully forwarded to the next computer. Setting the Recoverable property to true could affect throughput.

If the message is transactional, Message Queuing automatically treats the message as recoverable, regardless of the value of the Recoverable property.

The following code example gets and sets the value of a message's Recoverable property.

// Set the message's Recoverable property.
orderMessage.Recoverable = true;

// Display the new value of the message's Recoverable property.
Console.WriteLine("Message.Recoverable: {0}",
    orderMessage.Recoverable);

// Set the message's Recoverable property.
orderMessage.set_Recoverable(true);
// Display the new value of the message's Recoverable property.
Console.WriteLine("Message.Recoverable: {0}", 
    System.Convert.ToString(orderMessage.get_Recoverable()));

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0

Community Additions

ADD
Show:
© 2016 Microsoft