MessageQueue.EnableConnectionCache-Eigenschaft

Artikel
08/20/2007

Ruft einen Wert ab, der angibt, ob die Anwendung einen Verbindungscache verwaltet, oder legt diesen fest.

Namespace: System.Messaging
Assembly: System.Messaging (in system.messaging.dll)

Syntax

'Declaration
Public Shared Property EnableConnectionCache As Boolean
'Usage
Dim value As Boolean

value = MessageQueue.EnableConnectionCache

MessageQueue.EnableConnectionCache = value

public static bool EnableConnectionCache { get; set; }

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

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

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

public static function get EnableConnectionCache () : boolean

public static function set EnableConnectionCache (value : boolean)

Eigenschaftenwert

true, wenn ein Verbindungscache erstellt und verwendet wird, andernfalls false.

Hinweise

Ein Verbindungscache ist eine Liste von Verweisen auf Strukturen, die Schreib- oder Lesehandles für Warteschlangen enthalten. Wenn EnableConnectionCache true ist, verwendet die MessageQueue bei jedem Aufruf von Send(Object), Peek oder Receive Handles aus dem Cache, anstatt neue Handles zu öffnen. Dies kann die Leistung verbessern. Durch das Verwenden eines Verbindungscaches ist die MessageQueue außerdem unabhängig von Änderungen in der Netzwerktopologie.

Wenn Sie eine neue Verbindung mit einer Warteschlange erstellen und keine weiteren Einträge mehr im Verbindungscache möglich sind, überschreibt die MessageQueue die Struktur, auf die am längsten nicht mehr zugegriffen wurde, mit der neuen Verbindung. Sie können den Cache vollständig löschen, indem Sie ClearConnectionCache aufrufen, beispielsweise dann, wenn sich die Formatnamen der verwendeten Warteschlangen geändert haben und die bisherigen Lese- und Schreibhandles damit ungültig sind.

Der folgenden Tabelle können Sie entnehmen, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokaler Computer	Ja
Lokaler Computer + direkter Formatname	Ja
Remotecomputer	Ja
Lokaler Computer + direkter Formatname	Ja

Beispiel

Im folgenden Codebeispiel wird der Wert der EnableConnectionCache-Eigenschaft einer Meldungswarteschlange abgerufen und festgelegt.

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

// 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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

MessageQueue-Klasse
MessageQueue-Member
System.Messaging-Namespace
ClearConnectionCache

Freigeben über