MessageQueue.EnableConnectionCache Propriété

Définition

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é

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

Attributs

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 en lecture ou en écriture dans des files d’attente. Quand EnableConnectionCache a la valeur true, les MessageQueue handles empruntent au cache chaque fois que vous appelez Send(Object), Peekou Receive, plutôt que d’ouvrir de nouveaux handles. Cela peut améliorer les performances. L’utilisation d’un cache de connexion permet également d’isoler le MessageQueue des modifications apportées à la topologie réseau.

Si vous créez une connexion à une file d’attente lorsque le cache de connexion est plein, le MessageQueue remplace la structure la moins récemment consulté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 avec lesquelles vous travaillez ont changé de sorte que les handles de lecture et d’écriture précédents ne sont 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

S’applique à

Voir aussi