Включение локального кэша Windows Server AppFabric (XML)
Windows Server AppFabric предоставляет возможность программной настройки клиента кэша или использования для этой цели файла конфигурации приложения. В приведенных в этом разделе процедурах описано, как включить локальный кэш на клиенте кэша при использовании файла конфигурации приложения на основе XML. Сведения о программном выполнении этой задачи см. в разделе Включение локального кэша Windows Server AppFabric.
В файле конфигурации приложения параметры локального кэша определяются в элементе localCache
, который является дочерним элементом по отношению к dataCacheClient
. Атрибут isEnabled
элемента localCache
определяет, включен локальный кэш или нет. Кроме того, элемент localCache
может отсутствовать (или закомментирован), что означает отключенное состояние локального кэша. Дополнительные сведения о параметрах файла конфигурации приложения см. в разделе Параметры конфигурации приложения (кэширование в Windows Server AppFabric).
При выполнении этих процедур предполагается, что среда разработки уже подготовлена, заданы все ссылки на сборки кэширования AppFabric и т. д. Дополнительные сведения см. в разделе Подготовка среды разработки клиента кэша (кэширование в Windows Server AppFabric).
Чтобы включить локальный кэш с помощью файла конфигурации приложения
Создайте файл конфигурации приложения с именем App.config и добавьте его в проект. Дополнительные сведения см. в разделе Начало работы с клиентом кэша Windows Server AppFabric (XML).
Добавьте элемент
localCache
в качестве дочернего в элементdataCacheClient
.Задайте значение атрибута
isEnabled
элементаlocalCache
равнымtrue
, чтобы задействовать локальный кэш.Задайте значение атрибута
sync
элементаlocalCache
. Задайте для этого атрибута значениеTimeoutBased
, чтобы использовать время ожидания для ограничения срока действия локального кэша. Используйте объектNotificationBased
для дополнительного использования уведомления кэша о недействительности локального кэша. Для функционирования параметраNotificationsBased
необходимо включить уведомления для именованного кэша. Дополнительные сведения см. в разделе Уведомления кэша (кэширование в Windows Server AppFabric).Задайте для атрибута
ttlValue
элементаlocalCache
значение, равное необходимому количеству секунд, в течение которого объекты должны оставаться в локальном кэше. По умолчанию используется значение 300 секунд. Дополнительные сведения см. в разделе Окончание срока действия и вытеснение (кэширование в Windows Server AppFabric).Кроме того, задайте значение для атрибута
objectCount
элементаlocalCache
, чтобы указать максимальное количество объектов, сохраняемых в локальном кэше. По умолчанию значение равно 10 000 объектов. Это пороговое значение приводит к тому, что клиент кэша исключает из локального кэша 20 процентов наименее используемых объектов.Кроме того, если используются уведомления и необходимо указать интервал опроса, отличающийся от значения по умолчанию, равного 300 секундам, добавьте элемент
clientNotification
в качестве дочернего по отношению к элементуdataCacheClient
. Используйте атрибутpollInterval
элементаclientNotification
для указания значения интервала опроса. Этот элемент и атрибут могут использоваться для указания интервала опроса для уведомлений кэша, даже если нет необходимости использовать локальный кэш.
Пример
В этом примере показано, как выглядит элемент задействованного локального кэша. Этот элемент должен быть добавлен в рамках элемента dataCacheClient
.
XML
<!-- local cache enabled -->
<localCache
isEnabled="true"
sync="TimeoutBased"
objectCount="100000"
ttlValue="300" />
В этом примере в файле конфигурации приложения включен локальный кэш с указанием на один сервер кэша CacheServer1
. Чтобы использовать этот пример, замените имя сервера в примере на имя используемого сервера кэша. Добавьте или удалите теги узла в соответствии с потребностями среды.
В идеале следует указать те узлы кэша, которые были назначены ведущими узлами кэша. Как правило, ведущие узлы — это первые серверы кэша, установленные в кластере. Дополнительные сведения о ведущих узлах см. в разделе Схема физической архитектуры кэширования Windows Server AppFabric. Можно определить, какие узлы являются ведущими, используя средство администрирования Windows PowerShell. Дополнительные сведения о Windows PowerShell см. в разделе Использование Windows PowerShell для управления компонентами кэширования в Windows Server AppFabric.
Примечание
Поначалу Visual Basic может автоматически добавлять элементы в файл конфигурации приложения. Эти дополнительные элементы не являются обязательными для использования функций кэширования в AppFabric и могут быть удалены, если в них не нуждаются разрабатываемые приложения.
XML
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<!--configSections must be the FIRST element -->
<configSections>
<!-- required to read the <dataCacheClient> element -->
<section name="dataCacheClient"
type="Microsoft.ApplicationServer.Caching.DataCacheClientSection,
Microsoft.ApplicationServer.Caching.Core, Version=1.0.0.0,
Culture=neutral, PublicKeyToken=31bf3856ad364e35"
allowLocation="true"
allowDefinition="Everywhere"/>
</configSections>
<dataCacheClient>
<!-- (optional) specify local cache -->
<localCache
isEnabled="true"
sync="TimeoutBased"
objectCount="100000"
ttlValue="300" />
<!--(optional) specify cache notifications poll interval
<clientNotification pollInterval="300" /> -->
<hosts>
<host
name="CacheServer1"
cachePort="22233"/>
</hosts>
</dataCacheClient>
</configuration>
См. также
Основные понятия
Начало работы с клиентом кэша Windows Server AppFabric (XML)
Настройка поставщика состояний сеансов ASP.NET (кэширование в Windows Server AppFabric)
Клиенты кэша и локальный кэш (кэширование в Windows Server AppFabric)
Использование методов настройки (кэширование в Windows Server AppFabric)
Основные принципы кэширования Windows Server AppFabric
Разработка клиента кэша (кэширование в Windows Server AppFabric)
2011-12-05