次の方法で共有

Message.TimeToReachQueue プロパティ

  • [アーティクル]

メッセージがキューに到達するまでの最大許容時間を取得または設定します。

Public Property TimeToReachQueue As TimeSpan
[C#]
public TimeSpan TimeToReachQueue {get; set;}
[C++]
public: __property TimeSpan get_TimeToReachQueue();public: __property void set_TimeToReachQueue(TimeSpan);
[JScript]
public function get TimeToReachQueue() : TimeSpan;public function set TimeToReachQueue(TimeSpan);

プロパティ値

メッセージの送信が開始されてから送信先キューに到達するまでのタイム リミット。既定値は InfiniteTimeout です。

例外

例外の種類 条件
InvalidOperationException フィルタ処理されたメッセージ キューが、 TimeToReachQueue プロパティを無視します。
ArgumentException TimeToReachQueue に指定された値が無効です。負数を表している可能性があります。

解説

メッセージが送信先に到達する前に TimeToReachQueue プロパティによって指定される間隔が終了すると、メッセージ キューは次のどちらかの方法でそのメッセージを破棄します。メッセージの UseDeadLetterQueue プロパティが true の場合、メッセージは配信不能キューに送信されます。 UseDeadLetterQueue が false の場合、メッセージは無視されます。

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

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

TimeToReachQueue プロパティによって指定される値が TimeToBeReceived プロパティによって指定される値より大きいときは、 TimeToBeReceived が適用されます。

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

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

参照

Message クラス | Message メンバ | System.Messaging 名前空間 | TimeToBeReceived | InfiniteTimeout