MsmqBindingElementBase.TimeToLive 屬性

定義

命名空間:

System.ServiceModel.Channels

組件:

System.ServiceModel.dll

取得或設定指定訊息有效時間長度的值。 經過這個時間之後，訊息就會根據 DeadLetterQueue 設定放在寄不出的信件佇列中。

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

public TimeSpan TimeToLive { get; set; }

member this.TimeToLive : TimeSpan with get, set

Public Property TimeToLive As TimeSpan

屬性值

TimeSpan

指定訊息有效時間長度的 TimeSpan 值。 預設值為 24 小時。

例外狀況

ArgumentOutOfRangeException

這個值小於零。

-或-

這個值不是無限的，且會大於 Int32.MaxValue 毫秒。

備註

佇列應用程式是以中斷連線的方式運作， 這表示傳送和接收應用程式可能不會同時執行；因此，由傳送應用程式傳送的訊息可能不會由接收應用程式立即處理。 有些訊息包含的資訊只在特定期間內有效。 如果這類訊息沒有在該期間內傳遞，就不再包含有用的資訊且會被捨棄。 這個屬性可讓您指定訊息在傳遞至應用程式佇列之前要保留的時限。 如果在將訊息傳遞至應用程式佇列之前就超過這個時間限制，而且有寄不出的信件佇列可用，則會將訊息放在其中 (由 DeadLetterQueue 屬性判斷)；否則，就會捨棄訊息。