MessageQueue.EnableConnectionCache MessageQueue.EnableConnectionCache MessageQueue.EnableConnectionCache MessageQueue.EnableConnectionCache Property

Определение

Получает или задает значение, указывающее, будет ли приложение поддерживать кэш подключений.Gets or sets a value that indicates whether a cache of connections will be maintained by the application.

public:
 static property bool EnableConnectionCache { bool get(); void set(bool value); };
[System.ComponentModel.Browsable(false)]
public static bool EnableConnectionCache { get; set; }
member this.EnableConnectionCache : bool with get, set
Public Shared Property EnableConnectionCache As Boolean

Значение свойства

Значение true, если необходимо создать и использовать кэш подключений; в противном случае — значение false.true to create and use a connection cache; otherwise, false.

Примеры

В следующем примере кода получается и задается значение EnableConnectionCache свойства очереди сообщений.The following code example gets and sets the value of a message queue's EnableConnectionCache property.

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

Комментарии

Кэш подключений — это список ссылок на структуры, которые содержат дескрипторы чтения или записи для очередей.A connection cache is a list of references to structures that contain read or write handles to queues. Если EnableConnectionCache имеет trueзначение, MessageQueue то при каждом вызове метода Send(Object) Peek, или Receive, вместо открытия новых дескрипторов они будут обрабатываться из кэша.When EnableConnectionCache is true, the MessageQueue borrows handles from the cache each time you call Send(Object), Peek, or Receive, rather than open new handles. Это может повысить производительность.This can improve performance. Использование кэша подключений также изолирует MessageQueue изменения в топологии сети.Using a connection cache also insulates the MessageQueue from changes in the network topology.

При создании нового соединения с очередью, когда кэш подключения полон, объект MessageQueue перезаписывает самый последний доступную структуру с новым соединением.If you create a new connection to a queue when the connection cache is full, the MessageQueue overwrites the least recently accessed structure with the new connection. Можно полностью очистить кэш, вызвав ClearConnectionCache, например, если имена форматов очередей, с которыми вы работаете, изменились, чтобы предыдущие дескрипторы чтения и записи стали недействительными.You can clear the cache entirely by calling ClearConnectionCache, for example, if the format names of the queues you are working with have changed so that the previous read and write handles are no longer valid.

В следующей таблице показано, доступно ли это свойство в различных режимах рабочей группы.The following table shows whether this property is available in various Workgroup modes.

Режим рабочей группыWorkgroup mode ДоступноAvailable
Локальный компьютерLocal computer ДаYes
Локальный компьютер и прямое имя форматаLocal computer and direct format name ДаYes
Удаленный компьютерRemote computer ДаYes
Удаленный компьютер и прямое имя форматаRemote computer and direct format name ДаYes

Применяется к

Дополнительно