MessagePropertyFilter.Recoverable 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示接收或查看消息时是否检索 Recoverable 属性信息。
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
属性值
如果接收 Recoverable 信息,则为 true
;否则为 false
。 默认值为 false
。
- 属性
示例
下面的代码示例演示如何使用 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);
// 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);
注解
Recoverable类的 Message 属性指示是否保证消息的传递,即使当消息路由到目标队列时计算机崩溃也是如此。
如果保证邮件的传递,则消息将存储在每个步骤本地,直到消息成功转发到下一台计算机。 在消息上将 设置为 Message.Recoverabletrue
可能会影响吞吐量。