Message.TimeToBeReceived プロパティ

  • リファレンス

定義

名前空間:
System.Messaging
アセンブリ:
System.Messaging.dll

メッセージが送信先キューから受信されるまでの最大時間を取得または設定します。

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

プロパティ値

TimeSpan

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

属性
TypeConverterAttribute MessagingDescriptionAttribute

例外

InvalidOperationException

メッセージ キューがフィルター処理され、TimeToBeReceived プロパティを無視します。

ArgumentException

TimeToBeReceived に指定した値が無効です。

例

次のコード例では、メッセージ TimeToBeReceived の プロパティの値を取得および設定します。

注釈

プロパティは TimeToBeReceived 、送信先キューから送信されたメッセージを受信する合計時間を指定します。 制限時間には、宛先キューへのアクセスに費やされた時間と、メッセージを受信するまでのキューでの待機に費やされた時間が含まれます。

注意事項

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

メッセージがキューから削除される前に TimeToBeReceived 、 プロパティで指定された間隔が切れた場合、メッセージ キューは 2 つの方法のいずれかでメッセージを破棄します。 メッセージの UseDeadLetterQueue プロパティが true の場合、メッセージは配信不能キューに送信されます。 が のfalse場合UseDeadLetterQueue、メッセージは無視されます。

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

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

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

適用対象

こちらもご覧ください