MessageQueue.EnableConnectionCache プロパティ

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

MessageQueue.EnableConnectionCache プロパティ

接続のキャッシュをアプリケーションで維持するかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Shared Property EnableConnectionCache
 As Boolean

Visual Basic (使用法)

Dim value As Boolean

value = MessageQueue.EnableConnectionCache

MessageQueue.EnableConnectionCache = value

C#

public static bool EnableConnectionCache
 { get; set; }

C++

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

J#

/** @property */
public static boolean get_EnableConnectionCache
 ()

/** @property */
public static void set_EnableConnectionCache
 (boolean value)

JScript

public static function get
 EnableConnectionCache () : boolean

public static function set
 EnableConnectionCache (value : boolean)

プロパティ値
接続キャッシュを作成し、使用する場合は true。それ以外の場合は false。

解説

接続キャッシュは、キューへの読み取りハンドルまたは書き込みハンドルを含む構造体への参照のリストです。EnableConnectionCache が true の場合、Send(Object)、Peek、または Receive を呼び出すたびに、MessageQueue は新しいハンドルを開かずに、キャッシュからハンドルを借用します。これによってパフォーマンスが向上します。また、接続キャッシュを使用すると、MessageQueue がネットワーク トポロジの変更から遮断されます。

接続キャッシュが飽和状態のときにキューへの新しい接続を作成すると、MessageQueue は最後にアクセスされてから最も長い時間が経過している構造体を新しい接続で上書きします。作業をしているキューの書式名が変更されて、前回の読み取りハンドルと書き込みハンドルが無効になった場合などは、ClearConnectionCache を呼び出すことによってキャッシュ全体を消去できます。

このプロパティが各種のワークグループ モードで使用できるかどうかを次の表に示します。

ワークグループ モード	使用可否
ローカル コンピュータ	○
ローカル コンピュータと直接書式名	○
リモート コンピュータ	○
リモート コンピュータと直接書式名	○

使用例

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

C#

// Set the MessageQueue.EnableConnectionCache property value.
MessageQueue.EnableConnectionCache = false;

// Display the new value of the MessageQueue.EnableConnectionCache
// property.
Console.WriteLine("MessageQueue.EnableConnectionCache: {0}",
    MessageQueue.EnableConnectionCache);

J#

// Set the MessageQueue.EnableConnectionCache property value.
MessageQueue.set_EnableConnectionCache(false);
// Display the new value of the MessageQueue.EnableConnectionCache
// property.
Console.WriteLine("MessageQueue.EnableConnectionCache: {0}", 
    System.Convert.ToString(MessageQueue.get_EnableConnectionCache()));

.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

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
ClearConnectionCache