Добавление кэша 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
- Кордова
Функция подключенной службы добавляет все необходимые ссылки и код подключения в проект и изменяет файлы конфигурации соответствующим образом.
Необходимые условия
- Visual Studio с установленной рабочей нагрузкой Azure.
- Проект одного из поддерживаемых типов
- Учетная запись Azure. Если у вас нет учетной записи Azure, активируйте преимущества Azure для подписчиков Visual Studio или зарегистрируйтесь для получения бесплатной пробной версии.
Подключение к кэшу Azure для Redis с помощью подключенных служб
Откройте проект в Visual Studio.
В Обозревателе решений, щелкните правой кнопкой мыши узел подключенных служб, и в контекстном меню выберите Добавить подключенную службу.
Если узел подключенных служб не отображается, выберите Project>Connected Services>Добавить.
На вкладке подключенных служб выберите значок "+" для зависимостей служб .
На странице Добавление зависимостей выберите Azure Cache для Redis.
Если вы еще не вошли, войдите в свою учетную запись Azure. Если у вас нет учетной записи Azure, вы можете зарегистрироваться для получения бесплатной пробной версии .
На экране Настройка кэша Azure для Redis выберите существующий кэш Azure для Redis и выберите Далее.
Если вам нужно создать новый компонент, перейдите к следующему шагу. В противном случае перейдите к шагу 7.
Чтобы создать кэш Azure для Redis, выполните приведенные действия.
Выберите Создать новый кэш Redis Azure в нижней части экрана.
Заполните кэш Azure для Redis: создайте новый экран и выберите Создать.
При отображении экрана настройки кэша Azure для Redis в списке появится новый кэш. Выберите новую базу данных в списке и выберите Далее.
Введите имя строки подключения или выберите значение по умолчанию, а затем выберите, где вы хотите, чтобы строка подключения хранилась: в локальном файле секретов или в Azure Key Vault.
На экране «сводка изменений» отображаются все сделанные изменения, которые будут внесены в проект, если вы завершите процесс. Если изменения выглядят нормально, нажмите кнопку Готово.
Подключение отображается в разделе Зависимости служб вкладки Подключенные службы.
Заметка
Для проектов .NET Framework пользовательский интерфейс подключенных служб немного отличается. Чтобы увидеть различия, сравните с версией этой страницы для Visual Studio 2019 .
Откройте проект в Visual Studio.
В обозревателе решений щелкните правой кнопкой мыши узел подключённых служб и затем в контекстном меню выберите Добавить, чтобы открыть меню доступных служб.
Если узел подключенных служб не отображается, выберите Project>Connected Services>Добавить.
Выберите Azure Cache для Redis. Появится страница подключения к зависимости. Вы увидите два варианта: один для локального эмулятора, кэш Redis в контейнере (локально), и один для подключения к живой службе Azure Cache for Redis. Вы можете сократить затраты и упростить раннюю разработку, начиная с локального эмулятора. Вы можете позже перейти на живую службу, повторив эти действия и выбрав другой вариант.
Если вы выбрали Azure Cache для Redis локально, нажмите Далее на экране Подключение к кэшу Redis в контейнере.
Укажите имя контейнера, образ контейнераи сопоставления портов или примите значения по умолчанию, затем нажмите кнопку Далее, чтобы просмотреть экран сводки изменений, на котором указано, какие изменения будут внесены в ваш проект. В проект добавляется ссылка на пакет NuGet, а код подключения для локального эмулятора добавляется в проект.
Если вы хотите подключиться к службе Azure, перейдите к следующему шагу или, если вы еще не вошли, войдите в учетную запись Azure, прежде чем продолжить. Если у вас нет учетной записи Azure, вы можете зарегистрироваться для получения бесплатной пробной версии .
Чтобы перейти к активному сервису, выберите Azure Cache для Redis.
Если вы еще не вошли, войдите в свою учетную запись Azure. Если у вас нет учетной записи Azure, вы можете зарегистрироваться для получения бесплатной пробной версии .
На экране Настройка кэша Azure для Redis выберите существующий кэш Azure для Redis и выберите Далее.
Если вам нужно создать новый компонент, перейдите к следующему шагу. В противном случае перейдите к шагу 7.
Чтобы создать кэш Azure для Redis, выполните приведенные действия.
Выберите Создать новый кэш Redis Azure в нижней части экрана.
Заполните кэш Azure для Redis: создайте новый экран и выберите Создать.
При отображении экрана настройки кэша Azure для Redis в списке появится новый кэш. Выберите новую базу данных в списке и выберите Далее.
Введите имя параметра подключения или примите значение по умолчанию.
Заметка
Для повышения безопасности в Visual Studio 17.12 и более поздних версиях этот шаг создает имя параметра подключения; Предыдущие версии создают строку подключения. Строки подключения, хранящиеся в локальной файловой системе, могут привести к угрозе безопасности, если они непреднамеренно раскрыты.
Щелкните Дополнительные параметры и выберите, хотите ли вы сохранить параметр подключения в файле локальных секретов или в Azure Key Vault.
На экране «сводка изменений» отображаются все сделанные изменения, которые будут внесены в проект, если вы завершите процесс. Если изменения выглядят нормально, нажмите кнопку Готово.
В обозревателе решений дважды щелкните на узле Подключенные службы, чтобы открыть вкладку Подключенные службы. Подключение отображается в разделе Зависимости служб:
Если щелкнуть три точки рядом с добавленной зависимостью, можно увидеть различные параметры, такие как Connect, чтобы повторно открыть мастер и изменить подключение. Вы также можете щелкнуть три точки в правом верхнем углу окна, чтобы просмотреть параметры для запуска локальных зависимостей, изменения параметров и т. д.
Дальнейшие действия
Для приложений ASP.NET распространенные варианты использования кэша Azure для Redis — кэшировать состояние сеанса или выходные данные страницы (HTTP-ответы). ASP.NET Core предоставляет встроенные службы для этих вариантов использования, которые следует использовать вместо этого при использовании ASP.NET Core.
Для получения сведений о кэшировании состояния сеанса в приложении ASP.NET см. Провайдер состояния сеанса ASP.NET.
Чтобы кэшировать выходные данные страниц в приложении ASP.NET, см. раздел Поставщик кэша выходных данных ASP.NET.