MsmqBindingElementBase.TimeToLive 属性

定义

命名空间:

System.ServiceModel.Channels

程序集:

System.ServiceModel.dll

获取或设置一个值，该值指定消息有效的时长。 过了这段时间之后，会根据 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

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

例外

ArgumentOutOfRangeException

值小于零。

- 或 -

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

注解

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