DefaultPropertiesToSend.TimeToBeReceived プロパティ

定義

メッセージが送信先キューから取得されるまでのタイム リミットを取得または設定します。

public:
 property TimeSpan TimeToBeReceived { TimeSpan get(); void set(TimeSpan value); };
[System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))]
[System.Messaging.MessagingDescription("MsgTimeToBeReceived")]
public TimeSpan TimeToBeReceived { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Messaging.Design.TimeoutConverter))>]
[<System.Messaging.MessagingDescription("MsgTimeToBeReceived")>]
member this.TimeToBeReceived : TimeSpan with get, set
Public Property TimeToBeReceived As TimeSpan

プロパティ値

送信されたメッセージが送信先キューから受信されるまでの合計時間 (秒)。 既定値は、InfiniteTimeout です。

属性

注釈

プロパティは TimeToBeReceived 、送信先キューから送信されたメッセージを受信する合計時間を秒単位で指定します。 この制限時間には、宛先キューへの取得に費やされた時間と、アプリケーションによってメッセージが取得されるまでのキューでの待機に費やされた時間が含まれます。

注意事項

依存するクライアント コンピューターを使用する場合は、クライアント コンピューター上のクロックを、メッセージ キューを実行しているサーバー上のクロックと同期します。 2 つのクロックが同期されていない場合は、 が でないInfiniteTimeout場合にメッセージを送信するときに予期しない動作がTimeToBeReceived発生する可能性があります。

メッセージが TimeToBeReceived キューから削除される前に間隔が切れると、メッセージ キュー アプリケーションはメッセージを破棄します。 メッセージの プロパティが に設定されている場合UseDeadLetterQueueは配信不能キューにtrue送信されるか、 が の場合UseDeadLetterQueuefalseは無視されます。 が よりTimeToReachQueueTimeToBeReceived小さい場合TimeToBeReceivedは、 が優先されます。

メッセージの AcknowledgeType プロパティを設定すると、メッセージの有効期限が切れる前にメッセージが取得されない場合に、メッセージ キューが送信アプリケーションに否定受信確認メッセージを送信するように要求できます。

注意事項

負の受信確認を受信 TimeToReachQueue するように指定した場合、 の TimeToBeReceived 値が の値より TimeToReachQueue小さい場合、受信しません。

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

適用対象

こちらもご覧ください