Message.TimeToReachQueue プロパティ

.NET Framework クラス ライブラリ リファレンス

Message.TimeToReachQueue プロパティ

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

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Property TimeToReachQueue As
 TimeSpan

Visual Basic (使用法)

Dim instance As Message
Dim value As TimeSpan

value = instance.TimeToReachQueue

instance.TimeToReachQueue = value

C#

public TimeSpan TimeToReachQueue { get; set;
 }

C++

public:
property TimeSpan TimeToReachQueue {
    TimeSpan get ();
    void set (TimeSpan value);
}

J#

/** @property */
public TimeSpan get_TimeToReachQueue ()

/** @property */
public void set_TimeToReachQueue (TimeSpan
 value)

JScript

public function get TimeToReachQueue
 () : TimeSpan

public function set TimeToReachQueue
 (value : TimeSpan)

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

例外

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

解説

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

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

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

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

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

使用例

メッセージの TimeToReachQueue プロパティに対し、値の取得と設定を行うコード例を次に示します。

C#

// Set the message's TimeToReachQueue property to five minutes.
orderMessage.TimeToReachQueue = TimeSpan.FromMinutes(5.0);

// Display the new value of the message's TimeToReachQueue property.
Console.WriteLine("Message.TimeToReachQueue: {0}",
    orderMessage.TimeToReachQueue.ToString());

C++

// Set the message's TimeToReachQueue property to five minutes.
orderMessage->TimeToReachQueue = TimeSpan::FromMinutes(5.0);

// Display the new value of the message's TimeToReachQueue property.
Console::WriteLine("Message.TimeToReachQueue: {0}",
    orderMessage->TimeToReachQueue.ToString());

J#

// Set the message's TimeToReachQueue property to five minutes.
orderMessage.set_TimeToReachQueue(TimeSpan.FromMinutes(5.0));
// Display the new value of the message's TimeToReachQueue property.
Console.WriteLine("Message.TimeToReachQueue: {0}", 
    orderMessage.get_TimeToReachQueue().ToString());

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Message クラス
Message メンバ
System.Messaging 名前空間
Message.TimeToBeReceived プロパティ
InfiniteTimeout