MessagePropertyFilter.Recoverable Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Ruft einen Wert ab, der angibt, ob beim Einsehen oder beim Empfang einer Meldung die Recoverable-Eigenschaft abgerufen wird, oder legt diesen fest.

public:
 property bool Recoverable { bool get(); void set(bool value); };

[System.Messaging.MessagingDescription("MsgRecoverable")]
public bool Recoverable { get; set; }

[<System.Messaging.MessagingDescription("MsgRecoverable")>]
member this.Recoverable : bool with get, set

Public Property Recoverable As Boolean

Eigenschaftswert

Boolean

true, wenn Informationen über den Recoverable abgerufen werden, andernfalls false. Der Standardwert ist false.

Attribute

MessagingDescriptionAttribute

Beispiele

Im folgenden Codebeispiel wird die Verwendung des Recoverable-Attributs veranschaulicht.

// Set the queue's MessageReadPropertyFilter property 
// to enable the message's Recoverable property.
queue->MessageReadPropertyFilter->Recoverable = true;

// Peek at the message. Time out after ten seconds 
// in case the message was not delivered.
orderMessage = queue->Peek(TimeSpan::FromSeconds(10.0));

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

// Set the queue's MessageReadPropertyFilter property to enable the
// message's Recoverable property.
queue.MessageReadPropertyFilter.Recoverable = true;

// Peek at the message. Time out after ten seconds in case the message
// was not delivered.
orderMessage = queue.Peek(TimeSpan.FromSeconds(10.0));

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

Hinweise

Die Recoverable -Eigenschaft der Message -Klasse gibt an, ob die Zustellung einer Nachricht garantiert ist, auch wenn ein Computer abstürzt, während die Nachricht an die Zielwarteschlange weitergeleitet wird.

Wenn die Zustellung einer Nachricht garantiert ist, wird die Nachricht bei jedem Schritt lokal gespeichert, bis die Nachricht erfolgreich an den nächsten Computer weitergeleitet wurde. Die Einstellung Message.Recoverable auf für true die Nachricht kann sich auf den Durchsatz auswirken.

Weitere Informationen

• Recoverable
• MessageQueue