MessageQueue.EnableConnectionCache Eigenschaft

Definition

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

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

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

Eigenschaftswert

Boolean

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

Attribute

BrowsableAttribute

Beispiele

Im folgenden Codebeispiel wird der Wert der -Eigenschaft einer Nachrichtenwarteschlange EnableConnectionCache 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);

Hinweise

Ein Verbindungscache ist eine Liste von Verweisen auf Strukturen, die Lese- oder Schreibhandles für Warteschlangen enthalten. Wenn EnableConnectionCache isttrue, entlehnt der MessageQueue Handles aus dem Cache jedes Mal, wenn Sie , Peekoder ReceiveaufrufenSend(Object), anstatt neue Handles zu öffnen. Dies kann die Leistung verbessern. Die Verwendung eines Verbindungscaches isoliert auch vor MessageQueue Änderungen in der Netzwerktopologie.

Wenn Sie eine neue Verbindung mit einer Warteschlange erstellen, wenn der Verbindungscache voll ist, überschreibt die Struktur, auf die MessageQueue zuletzt am wenigsten zugegriffen wurde, mit der neuen Verbindung. Sie können den Cache vollständig löschen, indem Sie aufrufen ClearConnectionCache, z. B. wenn die Formatnamen der Warteschlangen, mit denen Sie arbeiten, so geändert wurden, dass die vorherigen Lese- und Schreibhandles nicht mehr gültig sind.

Die folgende Tabelle zeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokalem Computer	Ja
Name des lokalen Computers und direktes Format	Ja
Remotecomputer	Ja
Name des Remotecomputers und des direkten Formats	Ja

Weitere Informationen

• ClearConnectionCache()