MessageQueue.EnableConnectionCache Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Cache von Verbindungen von der Anwendung verwaltet wird.
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
trueum einen Verbindungscache zu erstellen und zu verwenden; andernfalls . false
- Attribute
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 Schreibziehpunkte für Warteschlangen enthalten. Wenn EnableConnectionCache dies der Zeitpunkt isttrue, werden die MessageQueue Ziehpunkte bei jedem Aufruf Send(Object)Peekdes Caches aus dem Cache geliehen, oder Receive, anstatt neue Handles zu öffnen. Dies kann die Leistung verbessern. Die Verwendung eines Verbindungscaches isoliert auch die MessageQueue Änderungen in der Netzwerktopologie.
Wenn Sie eine neue Verbindung zu einer Warteschlange erstellen, wenn der Verbindungscache voll ist, überschreibt die MessageQueue zuletzt aufgerufene Struktur mit der neuen Verbindung. Sie können den Cache vollständig löschen, indem Sie beispielsweise aufrufen ClearConnectionCache, wenn die Formatnamen der Warteschlangen, mit denen Sie arbeiten, geändert wurden, sodass die vorherigen Lese- und Schreibhandles nicht mehr gültig sind.
In der folgenden Tabelle wird gezeigt, ob diese Eigenschaft in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokaler Computer | Ja |
| Name des lokalen Computers und des direkten Formats | Ja |
| Remotecomputer | Ja |
| Name des Remotecomputers und des direkten Formats | Ja |