此页面有用吗?
您对此内容的反馈非常重要。 请告诉我们您的想法。
更多反馈?
1500 个剩余字符
TimeToLive 属性

BrokeredMessage.TimeToLive 属性

注:本页面内容可能不完全适用中国大陆地区运营的 Windows Azure服务。如要了解不同地区 Windows Azure 服务的差异, 请参考本网站.

获取或设置消息的生存时间值。这是消息过期之前的持续时间,从消息发送到服务总线开始计算。

超过 TimeToLive 值的消息将会过期,不再保留在消息存储中。订户无法接收过期的消息。

TimeToLive 是消息可获得的最长生存时间,但其值不能超过在目标队列或订阅上指定 DefaultMessageTimeToLive 值的实体。如果指定的 TimeToLive 值较小,则会将该值应用于各个消息。但是,如果消息上指定了较大的值,该值将由实体的 DefaultMessageTimeToLive 值覆盖。

命名空间:  Microsoft.ServiceBus.Messaging
程序集:  Microsoft.ServiceBus(在 Microsoft.ServiceBus.dll 中)

声明
Public Property TimeToLive As TimeSpan 
	Get 
	Set
用法
Dim instance As BrokeredMessage 
Dim value As TimeSpan 

value = instance.TimeToLive

instance.TimeToLive = value

属性值

类型:System.TimeSpan
消息的生存时间值。

异常条件
ObjectDisposedException

如果消息处于已释放状态,则会引发此异常。

ArgumentOutOfRangeException

如果传入的值小于或等于 TimeSpan.Zero,则会引发此异常。

如果启用了死信,则消息在 TTL 到期时将移动到死信队列。否则,消息将从系统中丢弃。请参阅 EnableDeadLetteringOnMessageExpirationEnableDeadLetteringOnMessageExpiration,了解有关如何分别控制队列和订阅的死信设置的详细信息。

如果发送器在消息上设置的 TTL 超过了目标的 TTL,则后面的值将覆盖消息的 TTL。请参阅 DefaultMessageTimeToLiveDefaultMessageTimeToLiveDefaultMessageTimeToLive,了解有关如何在实体级别控制消息 TTL 的详细信息。

如果没有对队列或订阅的接收操作,则 MessageCount 属性可能包括其 TimeToLive 已过期的消息。如果对队列调用接收操作,则将不传递过期的消息,并将相应地更新 MessageCount 属性。

TimeToLive 没有最小或最大绑定。

社区附加资源

添加
显示:
© 2015 Microsoft