BrokeredMessage.TimeToLive プロパティ

定義

有効な値に対するメッセージの時刻を取得または設定します。 これは、メッセージが 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.Zero 以下の場合にスローされます。

注釈

送信者がメッセージに設定した TTL が宛先の TTL を超えた場合、メッセージの TTL は後の TTL によって上書きされます。 エンティティ レベルでメッセージ TTL を制御する方法の詳細については、 DefaultMessageTimeToLiveDefaultMessageTimeToLive および DefaultMessageTimeToLive を参照してください。

適用対象