MessageQueue.EnableConnectionCache プロパティ

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

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

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

[System.ComponentModel.Browsable(false)]
public static bool EnableConnectionCache { get; set; }

[<System.ComponentModel.Browsable(false)>]
static member EnableConnectionCache : bool with get, set

Public Shared Property EnableConnectionCache As Boolean

プロパティ値

Boolean

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

属性

BrowsableAttribute

例

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

// 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);

注釈

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

接続キャッシュがいっぱいのときにキューへの新しい接続を作成すると、 MessageQueue によって、最近アクセスされた最も新しい構造体が新しい接続で上書きされます。 キャッシュを完全にクリアするには、 を呼び出 ClearConnectionCacheします。たとえば、操作しているキューの形式名が変更され、前の読み取りハンドルと書き込みハンドルが無効になった場合などです。

次の表は、このプロパティがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	はい
ローカル コンピューターと直接の形式名	はい
リモート コンピューター	はい
リモート コンピューターと直接形式の名前	はい

こちらもご覧ください

• ClearConnectionCache()