MessageQueue.EnableConnectionCache Propriété

Définition

Espace de noms:

System.Messaging

Assembly:

System.Messaging.dll

Obtient ou définit une valeur qui indique si l'application conservera un cache de connexions.

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

Valeur de propriété

Boolean

true pour créer et utiliser un cache de connexions, sinon false.

Attributs

BrowsableAttribute

Exemples

L’exemple de code suivant obtient et définit la valeur de la propriété d’une file d’attente de EnableConnectionCache messages.

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

Remarques

Un cache de connexion est une liste de références à des structures qui contiennent des handles de lecture ou d’écriture dans des files d’attente. Quand EnableConnectionCache a la valeur true, le MessageQueue emprunte les handles du cache chaque fois que vous appelez Send(Object), Peekou Receive, au lieu d’ouvrir de nouveaux handles. Cela peut améliorer les performances. L’utilisation d’un cache de connexion isole également le MessageQueue des modifications apportées à la topologie du réseau.

Si vous créez une connexion à une file d’attente lorsque le cache de connexion est saturé, le MessageQueue remplace la structure la moins récemment sollicitée par la nouvelle connexion. Vous pouvez effacer entièrement le cache en appelant ClearConnectionCache, par exemple, si les noms de format des files d’attente que vous utilisez ont changé de sorte que les handles de lecture et d’écriture précédents ne soient plus valides.

Le tableau suivant indique si cette propriété est disponible dans différents modes de groupe de travail.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Oui
Ordinateur distant et nom de format direct	Oui

Voir aussi

• ClearConnectionCache()