你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

BrokeredMessage.TimeToLive 属性

定义

命名空间:

Microsoft.ServiceBus.Messaging

程序集:

Microsoft.ServiceBus.dll

包:

WindowsAzure.ServiceBus v6.2.2

获取或设置消息的生存时间值。 这是消息到期之前所要经过的持续时间，从向 Service Bus 发送该消息时算起。 超过 TimeToLive 值的消息将会到期，不再保留在消息存储中。 订阅者将无法接收过期的消息。TimeToLive 是消息可以接收的最长生存期，但其值不能超过在目标队列或订阅上指定 DefaultMessageTimeToLive 值的实体。 如果指定了较低的 TimeToLive 值，则该值将应用于单个消息。 但是，在消息上指定的较大值将被实体的 DefaultMessageTimeToLive 值覆盖。

public TimeSpan TimeToLive { get; set; }

member this.TimeToLive : TimeSpan with get, set

Public Property TimeToLive As TimeSpan

属性值

TimeSpan

消息的生存时间值。

例外

ObjectDisposedException

如果消息处于已释放状态，则引发。

ArgumentOutOfRangeException

如果传入的值小于或等于 TimeSpan.Zero，则引发。

注解

如果发件人在邮件上设置的 TTL 超过目标的 TTL，则消息的 TTL 将被后面的 TTL 覆盖。 DefaultMessageTimeToLive若要详细了解如何在实体级别控制消息 TTL，请参阅 DefaultMessageTimeToLive和 DefaultMessageTimeToLive 。