メッセージが送信先キューから取得されるまでのタイム リミットを取得または設定します。
Public Property TimeToBeReceived As TimeSpan
[C#]
public TimeSpan TimeToBeReceived {get; set;}
[C++]
public: __property TimeSpan get_TimeToBeReceived();public: __property void set_TimeToBeReceived(TimeSpan);
[JScript]
public function get TimeToBeReceived() : TimeSpan;public function set TimeToBeReceived(TimeSpan);
プロパティ値
送信されたメッセージが送信先キューから受信されるまでの合計時間 (秒)。既定値は InfiniteTimeout です。
解説
TimeToBeReceived プロパティは、送信されたメッセージが送信先キューから受信されるまでの合計時間 (秒) を指定します。このタイム リミットには、送信先キューに到達するまでにかかる時間と、アプリケーションによってメッセージが取得されるまでキュー内にとどまっている時間とが含まれます。
注意 依存型クライアント コンピュータを使用するときには、メッセージ キューを実行しているサーバーのクロックにクライアント コンピュータのクロックを同期させてください。この 2 つのクロックが同期していないと、 TimeToBeReceived が InfiniteTimeout に設定されていない場合、メッセージの送信時に予測できない動作が発生することがあります。
キューからメッセージが削除される前に TimeToBeReceived 間隔が終了すると、メッセージ キュー アプリケーションはそのメッセージを破棄します。メッセージの UseDeadLetterQueue プロパティが true に設定されている場合、メッセージは配信不能キューに送信されます。 UseDeadLetterQueue が false に設定されている場合、メッセージは無視されます。 TimeToBeReceived が TimeToReachQueue より小さい場合、 TimeToBeReceived が適用されます。
メッセージの AcknowledgeType プロパティを設定すると、タイマが時間切れになるまでにメッセージが取得されない場合に、メッセージ キューが送信元アプリケーションに否定受信確認メッセージを返すように要求できます。
注意 TimeToReachQueue の否定受信確認を受け取るように指定した場合、 TimeToBeReceived が TimeToReachQueue より小さいときには、否定受信確認を受け取りません。
1 つのトランザクションで複数のメッセージが送信されるときには、メッセージ キューは最初のメッセージの TimeToBeReceived プロパティの値を使います。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- 直前の呼び出し元の完全信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細の参照先 : 部分信頼コードからのライブラリの使用
参照
DefaultPropertiesToSend クラス | DefaultPropertiesToSend メンバ | System.Messaging 名前空間 | TimeToReachQueue | InfiniteTimeout | Message.TimeToBeReceived