Поделиться через


Добавление кэша Azure для Redis с помощью подключенных служб Visual Studio

С помощью Visual Studio можно подключить любой из следующих компонентов к Azure Cache для Redis, используя возможность Connected Services.

  • Консольное приложение .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (включая консольное приложение, WPF, Windows Forms, библиотеку классов)
  • Рабочая роль .NET Core
  • Функции Azure
  • Приложение универсальной платформы Windows
  • Кордова

Функция подключенной службы добавляет все необходимые ссылки и код подключения в проект и изменяет файлы конфигурации соответствующим образом.

Необходимые условия

Подключение к кэшу Azure для Redis с помощью подключенных служб

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

  2. В Обозревателе решений, щелкните правой кнопкой мыши узел подключенных служб, и в контекстном меню выберите Добавить подключенную службу.

    Если узел подключенных служб не отображается, выберите Project>Connected Services>Добавить.

  3. На вкладке подключенных служб выберите значок "+" для зависимостей служб .

    снимок экрана: подключенные службы, выбранные в области меню. Значок +выделен для выделения.

  4. На странице Добавление зависимостей выберите Azure Cache для Redis.

    снимок экрана страницы добавления зависимостей. Выбран кэш Azure для Redis.

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

  5. На экране Настройка кэша Azure для Redis выберите существующий кэш Azure для Redis и выберите Далее.

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

    снимок экрана экрана настройки кэша Azure для Redis. Выделена кнопка 'Далее'.

  6. Чтобы создать кэш Azure для Redis, выполните приведенные действия.

    1. Выберите Создать новый кэш Redis Azure в нижней части экрана.

    2. Заполните кэш Azure для Redis: создайте новый экран и выберите Создать.

      Скриншот страницы создания новой кэш-памяти Azure для Redis. Создание выделено.

    3. При отображении экрана настройки кэша Azure для Redis в списке появится новый кэш. Выберите новую базу данных в списке и выберите Далее.

  7. Введите имя строки подключения или выберите значение по умолчанию, а затем выберите, где вы хотите, чтобы строка подключения хранилась: в локальном файле секретов или в Azure Key Vault.

    Снимок экрана: страница информации о подключении Azure Cache для Redis. Кнопка 'Далее' выделена.

  8. На экране «сводка изменений» отображаются все сделанные изменения, которые будут внесены в проект, если вы завершите процесс. Если изменения выглядят нормально, нажмите кнопку Готово.

    снимок экрана страницы

  9. Подключение отображается в разделе Зависимости служб вкладки Подключенные службы.

    снимок экрана со списком настроенных зависимостей службы.

Заметка

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

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

  2. В обозревателе решений щелкните правой кнопкой мыши узел подключённых служб и затем в контекстном меню выберите Добавить, чтобы открыть меню доступных служб.

    снимок экрана с параметрами контекстного меню

    Если узел подключенных служб не отображается, выберите Project>Connected Services>Добавить.

  3. Выберите Azure Cache для Redis. Появится страница подключения к зависимости. Вы увидите два варианта: один для локального эмулятора, кэш Redis в контейнере (локально), и один для подключения к живой службе Azure Cache for Redis. Вы можете сократить затраты и упростить раннюю разработку, начиная с локального эмулятора. Вы можете позже перейти на живую службу, повторив эти действия и выбрав другой вариант.

    снимок экрана, показывающий варианты Azure Cache для Redis

    Если вы выбрали Azure Cache для Redis локально, нажмите Далее на экране Подключение к кэшу Redis в контейнере.

    Снимок экрана, показывающий параметры подключения для кэша Azure для Redis в локальном контейнере.

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

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

  4. Чтобы перейти к активному сервису, выберите Azure Cache для Redis.

    снимок экрана страницы добавления зависимостей. Выбран кэш Azure для Redis.

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

  5. На экране Настройка кэша Azure для Redis выберите существующий кэш Azure для Redis и выберите Далее.

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

    снимок экрана экрана настройки кэша Azure для Redis. Выделена кнопка 'Далее'.

  6. Чтобы создать кэш Azure для Redis, выполните приведенные действия.

    1. Выберите Создать новый кэш Redis Azure в нижней части экрана.

    2. Заполните кэш Azure для Redis: создайте новый экран и выберите Создать.

      Скриншот страницы создания нового экземпляра Azure Cache для Redis. Выделена кнопка создания.

    3. При отображении экрана настройки кэша Azure для Redis в списке появится новый кэш. Выберите новую базу данных в списке и выберите Далее.

  7. Введите имя параметра подключения или примите значение по умолчанию.

    Снимок экрана: страница информации о подключении Azure Cache для Redis. Кнопка 'Далее' выделена.

    Заметка

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

  8. Щелкните Дополнительные параметры и выберите, хотите ли вы сохранить параметр подключения в файле локальных секретов или в Azure Key Vault.

    снимок экрана страницы дополнительных параметров Azure Cache для Redis.

  9. На экране «сводка изменений» отображаются все сделанные изменения, которые будут внесены в проект, если вы завершите процесс. Если изменения выглядят нормально, нажмите кнопку Готово.

    снимок экрана страницы

  10. В обозревателе решений дважды щелкните на узле Подключенные службы, чтобы открыть вкладку Подключенные службы. Подключение отображается в разделе Зависимости служб:

    снимок экрана со списком настроенных зависимостей службы.

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

Дальнейшие действия

Для приложений ASP.NET распространенные варианты использования кэша Azure для Redis — кэшировать состояние сеанса или выходные данные страницы (HTTP-ответы). ASP.NET Core предоставляет встроенные службы для этих вариантов использования, которые следует использовать вместо этого при использовании ASP.NET Core.

Для получения сведений о кэшировании состояния сеанса в приложении ASP.NET см. Провайдер состояния сеанса ASP.NET.

Чтобы кэшировать выходные данные страниц в приложении ASP.NET, см. раздел Поставщик кэша выходных данных ASP.NET.