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，訊息就會傳送到寄不出的信件佇列。 如果 為 UseDeadLetterQueuefalse，則會忽略訊息

您可以設定訊息的 AcknowledgeType 屬性，要求消息佇列在定時器到期前未送達訊息時，將負通知訊息傳回傳送應用程式。

TimeToReachQueue如果屬性設定為 0 秒，消息佇列會嘗試一次將訊息傳送至其目的地 ，如果佇列正在等候訊息。 如果佇列是本機佇列，訊息一律會到達它。

如果 屬性所 TimeToReachQueue 指定的值大於 屬性所 TimeToBeReceived 指定的值， TimeToBeReceived 則優先。

在單一交易中傳送數則訊息時，消息佇列會使用 TimeToReachQueue 第一個訊息的屬性。

另請參閱

• TimeToBeReceived
• InfiniteTimeout