Message.TimeToReachQueue 属性

定义

命名空间:

System.Messaging

程序集:

System.Messaging.dll

获取或设置消息到达队列所用的最长时间。

public:
 property TimeSpan TimeToReachQueue { TimeSpan get(); void set(TimeSpan value); };

[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToReachQueue")]
public TimeSpan TimeToReachQueue { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, set

Public Property TimeToReachQueue As TimeSpan

属性值

TimeSpan

从发送消息的时间开始算起，消息到达目标队列的时间限制。 默认值为 InfiniteTimeout。

属性

TypeConverterAttribute MessagingDescriptionAttribute

例外

InvalidOperationException

消息队列经过筛选后忽略了 TimeToReachQueue 属性。

ArgumentException

为 TimeToReachQueue 指定的值无效。 它可能表示负数。

示例

下面的代码示例获取并设置消息 TimeToReachQueue 的 属性的值。

注解

如果 属性指定的 TimeToReachQueue 间隔在消息到达其目标之前过期，则消息队列会以两种方式之一丢弃消息。 如果消息的 UseDeadLetterQueue 属性为 true，则将该消息发送到死信队列。 如果 UseDeadLetterQueue 为 false，则忽略消息

可以设置消息的 AcknowledgeType 属性，以请求消息队列在计时器过期前未到达时将否定确认消息发送回发送应用程序。

如果 属性 TimeToReachQueue 设置为 0 秒，则消息队列尝试一次将消息发送到其目标 - 如果队列正在等待消息。 如果队列是本地队列，则消息将始终到达该队列。

如果 属性指定的 TimeToReachQueue 值大于 属性指定的 TimeToBeReceived 值， TimeToBeReceived 则优先。

在单个事务中发送多个消息时，消息队列使用 TimeToReachQueue 第一条消息的 属性。

另请参阅

• TimeToBeReceived
• InfiniteTimeout