Подготовка среды разработки клиента кэша (кэширование в Windows Server AppFabric)

Статья
12/05/2011

В данном разделе описывается, как подготовить проект Visual Studio, чтобы можно было начать разработку приложений с включенным кэшем. В следующих процедурах подразумевается, что вы уже установили Windows Server AppFabric и настроили компоненты кэширования AppFabric на одном или нескольких серверах кэша или на рабочей станции разработки. Дополнительные сведения см. в документе Руководство по установке Windows Server AppFabric (https://go.microsoft.com/fwlink/?LinkId=169172).

Кроме установки компонентов кэширования AppFabric, необходимо выполнить следующие действия, чтобы клиент кэша смог получить доступ к кэшу:

В Windows PowerShell используйте Use-CacheCluster для задания контекста в целевом кластере кэша.
Создайте необходимые именованные кэши с помощью команды New-Cache.
Предоставьте доступ к учетной записи Windows клиента кэша с помощью команды Grant-CacheAllowedClientAccount.
Запустите кластер кэша с помощью команды Start-CacheCluster.

Дополнительные сведения об использовании Windows PowerShell и перечисленных здесь команд см. в разделе Использование Windows PowerShell для управления компонентами кэширования в Windows Server AppFabric.

Подготовка компьютера разработки

Единственное требование настройки для разработки приложения, которое использует компоненты кэширования AppFabric, заключается в наличии установленного компонента клиента кэша AppFabric. Возможно вести разработку на узле кэша, на котором установлены другие компоненты кэширования AppFabric, но компонент клиента кэша является единственным требованием для рабочей станции разработки.

Подготовка проекта Visual Studio

Сборки, необходимые для разработки приложений с включенным кэшем, устанавливаются в глобальный кэш сборок. Чтобы разработать приложение Visual Studio .NET, использующее эти сборки, необходимо сначала сослаться на них из проекта.

Чтобы определить правильную версию .NET Framework, выполните следующие действия:

Откройте проект Visual Studio .NET.
В обозревателе решений щелкните правой кнопкой мыши имя проекта и выберите пункт Свойства.
Выберите вкладку Приложение в диалоговом окне Свойства проекта.
Убедитесь, что целевой версией платформы является .NET Framework 2.0 или выше.

Важно!

Не используйте профиль клиента для целевой версии платформы. В Visual Studio 2008 снимите флажок Подмножество платформы, содержащее только клиент. В Visual Studio 2010 выберите версии .NET Framework versions that do not specify "Client Profile".

Добавлении ссылок на сборки кэширования AppFabric

Откройте проект Visual Studio .NET.
В обозревателе решений щелкните правой кнопкой мыши имя проекта и выберите пункт Добавить ссылку.
выберите вкладку Обзор в диалоговом окне Добавление ссылки.
Перейдите к каталогу .\Windows\System32\AppFabric.

Примечание

В 64-разрядных операционных системах каталог AppFabric изначально не отображается. Чтобы устранить эту проблему, замените имя каталога System32 на имя SysNative. Это позволит перейти в каталог C:\Windows\SysNative\AppFabric в данном шаге.
Добавьте ссылку в две следующие сборки: Microsoft.ApplicationServer.Caching.Client.dll и Microsoft.ApplicationServer.Caching.Core.dll.
При желании добавьте оператор using (Imports в Visual Basic) находится вверху файлов кода для создания ссылки на пространство имен Microsoft.ApplicationServer.Caching.

Настройка клиента кэша

Определите подходящие параметры клиента для приложения клиента. Дополнительные сведения о типах клиентов кэша см. в разделе Клиенты кэша и локальный кэш (кэширование в Windows Server AppFabric).
Настройте клиент кэша программно или с использованием файла конфигурации приложения. Соответствующие примеры см. в разделах Начало работы с клиентом кэша Windows Server AppFabric и Начало работы с клиентом кэша Windows Server AppFabric (XML).

Пример

Ниже приведен пример клиента кэша, настроенного с использованием файла конфигурации приложения. В данном примере локальный кэш отключен и указаны два узла кэша: CacheServer1 и CacheServer2. Дополнительные сведения см. в разделе Начало работы с клиентом кэша Windows Server 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"/>
         <host
            name="CacheServer2"
            cachePort="22233"/>
      </hosts>
   </dataCacheClient>
</configuration>

Ниже приведен пример программной настройки клиента. В данном примере локальный кэш отключен, указан всего один сервер кэша (CacheServer2) и создается клиент кэша для кэша с именем NamedCache1. Дополнительные сведения см. в разделе Начало работы с клиентом кэша Windows Server AppFabric.

' Declare array for cache host(s).
Dim servers(0) As DataCacheServerEndpoint
servers(0) = New DataCacheServerEndpoint("CacheServer2", 22233)

' Setup the DataCacheFactory configuration.
Dim factoryConfig As DataCacheFactoryConfiguration
factoryConfig = New DataCacheFactoryConfiguration
factoryConfig.Servers = servers

' Create a configured DataCacheFactory object.
Dim mycacheFactory As DataCacheFactory
mycacheFactory = New DataCacheFactory(factoryConfig)

' Get a cache client for the cache "NamedCache1".
Dim myDefaultCache As DataCache
myDefaultCache = mycacheFactory.GetCache("NamedCache1")

// Declare array for cache host(s).
DataCacheServerEndpoint[] servers = new DataCacheServerEndpoint[1];
servers[0] = new DataCacheServerEndpoint("CacheServer2", 22233);

// Setup the DataCacheFactory configuration.
DataCacheFactoryConfiguration factoryConfig = new DataCacheFactoryConfiguration();
factoryConfig.Servers = servers;

// Create a configured DataCacheFactory object.
DataCacheFactory mycacheFactory = new DataCacheFactory(factoryConfig);

// Get a cache client for the cache "NamedCache1".
DataCache myDefaultCache = mycacheFactory.GetCache("NamedCache1");

См. также

Основные понятия

Параметры конфигурации приложения (кэширование в Windows Server AppFabric)
Параметры конфигурации клиента (кэширование в Windows Server AppFabric)
Конфигурация клиента, основанная на XML (кэширование в Windows Server AppFabric)
Программная настройка клиента (кэширование в Windows Server AppFabric)
Использование основных методов кэша (кэширование в Windows Server AppFabric)
Использование основных методов кэша (кэширование в Windows Server AppFabric)
Использование методов настройки (кэширование в Windows Server AppFabric)
Основные принципы кэширования Windows Server AppFabric

Другие ресурсы

Настройка клиента кэша с помощью XML

2011-12-05