Экспорт (0) Печать
Развернуть все

Инструкция по подготовке Visual Studio к использованию общего Azure Caching

Обновлено: Сентябрь 2014 г.

ImportantВажно!
Обратите внимание, что использование службы общего кэша Azure и портала на базе Azure Silverlight будет прекращено с 1 сентября 2014 г. После прекращения использования службы общего кэша все оставшиеся развертывания службы общего кэша будут удалены. Корпорация Майкрософт настоятельно рекомендует как можно раньше перенести все существующие службы общего кэша на Управляемая служба кэша (в настоящее время общедоступна) или на новую службу кэша Redis для Azure (в настоящее время версия для предварительного просмотра). Руководство по миграции, включая руководство для миграции без внесения изменений в код, см. в разделе Переход от общего Caching. Дополнительные сведения текущих предложениях Azure Cache см. в разделе Кэш Azure.

В этом разделе рассказывается, как подготовить проект Visual Studio 2012 к использованию Microsoft Azure Shared Caching. Сюда входят следующие задачи.

  • Проверка правильности выбора целевой версии .NET Framework.

  • Добавление ссылок на сборки Shared Caching.

После этого вы можете настроить клиент кэша в разделе dataCacheClient файла конфигурации приложения или файла web.config. Это позволяет использовать методы кэширование в пространстве имен Microsoft.ApplicationServer.Caching.

WarningПредупреждение
Не следует устанавливать Microsoft AppFabric 1.1 для Windows Server и Кэш Microsoft Azure на одном компьютере. Это затрагивает как сам продукт, так и пакет SDK. В противном случае можно по ошибке сослаться на какие-либо сборки Microsoft AppFabric 1.1 для Windows Server в глобальном кэше сборок. Это может привести к неправильному или непредсказуемому поведению.

  1. Откройте проект Visual Studio 2012.

  2. В обозревателе решений щелкните правой кнопкой мыши имя проекта и выберите пункт Свойства.

  3. В проекте Visual C# выполните следующие действия.

    1. Выберите вкладку Приложение в диалоговом окне Свойства проекта.

    2. Убедитесь, что целевой версией платформы является .NET Framework 2.0 или выше (нельзя использовать клиентский профиль).

  4. В проекте Visual Basic выполните следующие действия.

    1. Выберите вкладку Компиляция в диалоговом окне Свойства проекта.

    2. В нижней части страницы Компиляция нажмите кнопку Дополнительные параметры компиляции.

    3. Убедитесь, что целевой версией платформы является .NET Framework 2.0 или выше (нельзя использовать клиентский профиль).

ImportantВажно!
Не используйте профиль клиента для целевой версии платформы. В Visual Studio выберите версии .NET Framework, не упоминающие "клиентский профиль".

Чтобы добавить ссылки на сборки, на компьютере должен быть установлен пакет SDK. Инструкции см. в разделе Загрузка пакета Azure SDK.

Далее используется пакет NuGet, добавляющий нужные ссылки на сборки и изменения в конфигурации. Эти действия относятся к Shared Caching.

  1. В обозревателе решений щелкните правой кнопкой мыши имя проекта и выберите пункт Добавить ссылку на пакет библиотеки (NuGet 1.2) или Управление пакетами NuGet (NuGet 2.0).

  2. В левой области выберите категорию В сети.

  3. Найдите WindowsAzure.Caching.

  4. Установите пакет Кэш в роли с именем WindowsAzure.Caching (NuGet 1.2) или Azure Shared Caching (NuGet 2.0).

    Снимок экрана пакета Shared Caching (NuGet 1,2)

    Снимок экрана пакета Shared Caching (NuGet 2,0)

Помимо добавления нужных ссылок на сборки, этот пакет также изменяет файл конфигурации (app.config или web.config) для целевого проекта. Он добавляет стандартный раздел dataCacheClients, аналогичный следующему.

<dataCacheClients>
  <dataCacheClient name="default">
    <hosts>
      <host name="[Insert Cache EndPoint]" cachePort="22233" />
    </hosts>
    <securityProperties mode="Message">
      <messageSecurity authorizationInfo="[Encrypted ACS token goes here]"></messageSecurity>
    </securityProperties>
  </dataCacheClient>
  <dataCacheClient name="SslEndpoint">
    <hosts>
      <host name="[Insert Cache EndPoint]" cachePort="22243" />
    </hosts>
    <securityProperties mode="Message" sslEnabled="true">
      <messageSecurity authorizationInfo="[Encrypted ACS token goes here]"></messageSecurity>
    </securityProperties>
  </dataCacheClient>
</dataCacheClients>

Последний шаг — это замена заполнителей в [Insert Cache EndPoint] и [Encrypted ACS token goes here]. Данные значения можно найти на . Обратите внимание, что сведения Shared Caching недоступны в новой версии . Чтобы найти их, нужно переключиться на предыдущую версию портала. Дополнительные сведения см. в разделе Инструкция по настройке клиента кэша с помощью файла конфигурации приложения (общий Azure Caching). Также существует возможность программной настройки доступа к кэшу. Дополнительные сведения см. в разделе Инструкция по Программная настройка клиента кэша (общий Azure Caching).

Пакет NuGet добавляет ссылки на следующие сборки:

  • Microsoft.ApplicationServer.Caching.Client

  • Microsoft.ApplicationServer.Caching.Core

  • Microsoft.Web.DistributedCache

  • Microsoft.WindowsFabric.Common

  • Microsoft.WindowsFabric.Data.Common

noteПримечание
Эти сборки можно добавить вручную без пакета NuGet. По умолчанию они устанавливаются в C:\Program Files\Microsoft SDKs\Microsoft Azure\.NET SDK\2012-10\ref\SharedCaching.

См. также

Показ:
© 2014 Microsoft