Message.Recoverable プロパティ

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

Message.Recoverable プロパティ

コンピュータの障害やネットワークの問題が発生したときにメッセージの配信が保証されるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property Recoverable As
 Boolean

Visual Basic (使用法)

Dim instance As Message
Dim value As Boolean

value = instance.Recoverable

instance.Recoverable = value

C#

public bool Recoverable { get;
 set; }

C++

public:
property bool Recoverable {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_Recoverable ()

/** @property */
public void set_Recoverable (boolean value)

JScript

public function get Recoverable
 () : boolean

public function set Recoverable
 (value : boolean)

プロパティ値
送信中にメッセージをディスクに保存することによって配信が保証される場合は true、配信が保証されない場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	フィルタ処理されたメッセージ キューが、Recoverable プロパティを無視します。

解説

Recoverable プロパティは、メッセージが送信先キューに送信される途中でコンピュータがクラッシュした場合にも、メッセージの配信が保証されるかどうかを示します。

メッセージの配信が保証される場合は、送信経路上の各ステップにおいて、メッセージが次のコンピュータに正常に転送されるまでメッセージがローカルに格納されます。ただし Recoverable プロパティを true に設定すると、スループットに影響することがあります。

メッセージがトランザクション メッセージである場合は、Recoverable プロパティの値に関係なく、メッセージ キューはそのメッセージを回復可能 (配信が保証される) として扱います。

使用例

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

C#

// Set the message's Recoverable property.
orderMessage.Recoverable = true;

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

C++

// Set the message's Recoverable property.
orderMessage->Recoverable = true;

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

J#

// Set the message's Recoverable property.
orderMessage.set_Recoverable(true);
// Display the new value of the message's Recoverable property.
Console.WriteLine("Message.Recoverable: {0}", 
    System.Convert.ToString(orderMessage.get_Recoverable()));

.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 名前空間
UseTracing