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


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

С помощью Visual Studio можно подключить любую из следующих функций к службе Azure SignalR с помощью функции подключенных служб:

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

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

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

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

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

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

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

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

    Добавить зависимость службы

  4. На странице Добавление зависимости выберите службу Azure SignalR.

    Добавить службу Azure SignalR

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

  5. На экране Настройка Azure SignalR выберите существующий компонент Azure SignalR и выберите Далее.

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

    Подключение к существующему компоненту Azure SignalR

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

    1. Выберите Создать новый экземпляр службы Azure SignalR в нижней части экрана.

    2. Заполните экран Azure SignalR Service: Create new и выберите Создать.

      новый экземпляр сервиса Azure SignalR

    3. При отображении экрана настройки службы Azure SignalR новый экземпляр появляется в списке. В списке выберите новый экземпляр, затем нажмите Далее.

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

    Указание строки подключения

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

    сводка измененийSummary of changesSummary of changes

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

    зависимости сервисов

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

Заметка

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

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

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

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

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

  3. Выберите Azure SignalR Service. Откроется страница Подключение к зависимостям.

    Снимок экрана, демонстрирующий подключение к зависимости Azure SignalR.

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

  4. Выберите существующий компонент Azure SignalR и выберите Далее.

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

    Скриншот, отображающий экран

  5. Чтобы создать экземпляр службы Azure SignalR, выполните приведенные действия.

    1. Выберите Создать новый в середине справа на экране.

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

      Снимок экрана, показывающий окно

    3. При отображении экрана настройки службы Azure SignalR новый экземпляр появляется в списке. В списке выберите новый экземпляр, затем нажмите Далее.

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

    Скриншот с экрана

    Заметка

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

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

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

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

    снимок экрана:

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

    снимок экрана с разделом

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

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

Продолжайте, следуя инструкции быстрого старта Azure SignalR. Вы можете пропустить начальную настройку, так как вы уже сделали это, и продолжить работу с разделом Добавить Azure SignalR в веб-приложение. Используемый код зависит от версии ASP.NET Core, поэтому может потребоваться изменить код в руководстве, чтобы соответствовать шаблону проекта, если версия ASP.NET Core не соответствует версии, используемой в кратком руководстве.