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 メッセージの宛先に到達するまでに期限切れになった場合、メッセージ キューは 2 つの方法のいずれかでメッセージを破棄します。 メッセージの UseDeadLetterQueue プロパティが true の場合、メッセージは配信不能キューに送信されます。 が falseの場合UseDeadLetterQueue、メッセージは無視されます

メッセージの AcknowledgeType プロパティを設定して、メッセージキューがメッセージがタイマーの期限切れになる前にメッセージが到着しない場合に、否定受信確認メッセージを送信側アプリケーションに送り返すよう要求できます。

プロパティが TimeToReachQueue 0 秒に設定されている場合、キューがメッセージを待機している場合、メッセージ キューはメッセージの送信先へのメッセージの送信を 1 回試行します。 キューがローカルの場合、メッセージは常にそれに到達します。

プロパティで指定された値が プロパティでTimeToReachQueueTimeToBeReceived指定された値より大きい場合は、 TimeToBeReceived が優先されます。

1 つのトランザクションで複数のメッセージが送信されると、メッセージ キューは最初のメッセージの プロパティを使用 TimeToReachQueue します。

適用対象

こちらもご覧ください