Message.TimeToReachQueue 属性

定义

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

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.Messaging.MessagingDescription("MsgTimeToReachQueue")]
[System.ComponentModel.TypeConverter(typeof(System.Messaging.TimeoutConverter))]
public TimeSpan TimeToReachQueue { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
member this.TimeToReachQueue : TimeSpan with get, set
[<System.Messaging.MessagingDescription("MsgTimeToReachQueue")>]
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.TimeoutConverter))>]
member this.TimeToReachQueue : TimeSpan with get, set
Public Property TimeToReachQueue As TimeSpan

属性值

TimeSpan

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

属性

例外

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

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

示例

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

注解

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

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

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

如果属性指定的值大于由该属性指定的TimeToReachQueueTimeToBeReceived值,TimeToBeReceived则优先。

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

适用于

另请参阅