Message.TimeToBeReceived プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
メッセージが送信先キューから受信されるまでの最大時間を取得または設定します。
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 プロパティを無視します。
TimeToBeReceived に指定した値が無効です。
例
次のコード例では、メッセージ TimeToBeReceived の プロパティの値を取得および設定します。
注釈
プロパティは TimeToBeReceived 、送信先キューから送信されたメッセージを受信する合計時間を指定します。 制限時間には、宛先キューへのアクセスに費やされた時間と、メッセージを受信するまでのキューでの待機に費やされた時間が含まれます。
注意事項
依存するクライアント コンピューターを使用する場合は、クライアント コンピューター上のクロックが、メッセージ キューを実行しているサーバー上のクロックと同期されていることを確認します。 それ以外の場合、プロパティが ではないInfiniteTimeoutメッセージTimeToBeReceivedを送信すると、予期しない動作が発生する可能性があります。
メッセージがキューから削除される前に TimeToBeReceived 、 プロパティで指定された間隔が切れた場合、メッセージ キューは 2 つの方法のいずれかでメッセージを破棄します。 メッセージの UseDeadLetterQueue プロパティが true
の場合、メッセージは配信不能キューに送信されます。 が のfalse
場合UseDeadLetterQueue、メッセージは無視されます。
メッセージの AcknowledgeType プロパティを設定すると、メッセージの有効期限が切れる前にメッセージが取得されない場合に、メッセージ キューが送信アプリケーションに否定受信確認メッセージを送信するように要求できます。
プロパティで指定された値が TimeToBeReceived 、 プロパティで TimeToReachQueue 指定された値より小さい場合は、 TimeToBeReceived が優先されます。
1 つのトランザクションで複数のメッセージが送信されると、メッセージ キューは最初のメッセージの プロパティを使用 TimeToBeReceived します。
適用対象
こちらもご覧ください
.NET