MsmqBindingElementBase.TimeToLive 属性

定义

获取或设置一个值,该值指定消息有效的时长。 过了这段时间之后,会根据 DeadLetterQueue 设置将消息放置到死信队列中。

public:
 property TimeSpan TimeToLive { TimeSpan get(); void set(TimeSpan value); };
public TimeSpan TimeToLive { get; set; }
member this.TimeToLive : TimeSpan with get, set
Public Property TimeToLive As TimeSpan

属性值

一个 TimeSpan 值,它指定消息有效的时长。 默认值为 24 小时。

例外

值小于零。

- 或 -

该值不可为无穷大,并且要大于 Int32.MaxValue 毫秒。

注解

排队应用程序以断开连接的方式工作。 这意味着发送和接收应用程序可能不同时运行。因此,发送应用程序所发送的消息可能不会立即受到接收应用程序处理。 有些消息包含只在某个时间段内有效的信息。 这样的消息如果未在这个时间段内传送,则不再包含有用的信息,应予以丢弃。 使用此属性可以指定在将消息传递到应用程序队列之前,应保留该消息的时间限制。 如果在将消息传递到应用程序队列之前,过了此时间限制,则会将消息放置到可用的死信队列中(由 DeadLetterQueue 属性确定);否则,会丢弃消息。

适用于