Dodawanie usługi Azure SignalR przy użyciu usług połączonych programu Visual Studio

Program Visual Studio umożliwia połączenie dowolnej z następujących funkcji z usługą Azure SignalR przy użyciu funkcji Połączonych usług :

  • Aplikacja konsolowa .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (w tym aplikacja konsolowa, WPF, Windows Forms, biblioteka klas)
  • Rola procesu roboczego platformy .NET Core
  • Azure Functions
  • aplikacja platforma uniwersalna systemu Windows
  • Xamarin
  • Cordova

Funkcja połączonej usługi dodaje wszystkie wymagane odwołania i kod połączenia do projektu oraz odpowiednio modyfikuje pliki konfiguracji.

Uwaga

Ten temat dotyczy programu Visual Studio w systemie Windows. Aby uzyskać Visual Studio dla komputerów Mac, zobacz Połączone usługi w Visual Studio dla komputerów Mac.

Wymagania wstępne

Nawiązywanie połączenia z usługą Azure SignalR przy użyciu połączonych usług

  1. Otwórz projekt w programie Visual Studio.

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł Usługi połączone, a następnie z menu kontekstowego wybierz polecenie Dodaj połączoną usługę.

    Jeśli nie widzisz węzła Usługi połączone, wybierz pozycję Project Connected Services Add (Dodaj połączone usługi>projektu).>

  3. Na karcie Usługi połączone wybierz ikonę + dla pozycji Zależności usług.

    Dodawanie zależności usługi

  4. Na stronie Dodawanie zależności wybierz pozycję Azure SignalR Service.

    Dodawanie usługi Azure SignalR Service

    Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta platformy Azure, możesz skorzystać z bezpłatnej wersji próbnej.

  5. Na ekranie Konfigurowanie usługi Azure SignalR wybierz istniejący składnik usługi Azure SignalR , a następnie wybierz pozycję Dalej.

    Jeśli musisz utworzyć nowy składnik, przejdź do następnego kroku. W przeciwnym razie przejdź do kroku 7.

    Nawiązywanie połączenia z istniejącym składnikiem usługi Azure SignalR

  6. Aby utworzyć wystąpienie usługi Azure SignalR:

    1. Wybierz pozycję Utwórz nowe wystąpienie usługi Azure SignalR Service w dolnej części ekranu.

    2. Wypełnij pole Azure SignalR Service: Utwórz nowy ekran i wybierz pozycję Utwórz.

      Nowe wystąpienie usługi Azure SignalR Service

    3. Po wyświetleniu ekranu Konfigurowanie usługi Azure SignalR Service nowe wystąpienie zostanie wyświetlone na liście. Wybierz nowe wystąpienie na liście, a następnie wybierz pozycję Dalej.

  7. Wprowadź nazwę parametry połączenia lub wybierz wartość domyślną, a następnie wybierz, czy parametry połączenia przechowywany w lokalnym pliku wpisów tajnych, czy w usłudze Azure Key Vault.

    Określanie parametry połączenia

  8. Na ekranie Podsumowanie zmian zostaną wyświetlone wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz przycisk Zakończ.

    Podsumowanie zmian

  9. Połączenie jest wyświetlane w sekcji Zależności usług na karcie Połączone usługi .

    Zależności usługi

Nawiązywanie połączenia z usługą Azure SignalR przy użyciu połączonych usług

Uwaga

W przypadku projektów .NET Framework interfejs użytkownika połączonych usług jest nieco inny. Aby zobaczyć różnice, porównaj z wersją programu Visual Studio 2019 tej strony.

  1. Otwórz projekt w programie Visual Studio.

  2. W Eksplorator rozwiązań kliknij prawym przyciskiem myszy węzeł Usługi połączone, a następnie z menu kontekstowego wybierz polecenie Dodaj, aby otworzyć menu dostępnych usług.

    Zrzut ekranu przedstawiający opcje menu kontekstowego usług połączonych.

    Jeśli nie widzisz węzła Usługi połączone, wybierz pozycję Project Connected Services Add (Dodaj połączone usługi>projektu).>

  3. Wybierz pozycję Azure SignalR Service. Zostanie wyświetlona strona Łączenie z zależnością .

    Zrzut ekranu przedstawiający połączenie z zależnością dla usługi Azure SignalR.

    Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta platformy Azure, możesz skorzystać z bezpłatnej wersji próbnej.

  4. Wybierz istniejący składnik usługi Azure SignalR, a następnie wybierz pozycję Dalej.

    Jeśli musisz utworzyć nowy składnik, przejdź do następnego kroku. W przeciwnym razie przejdź do kroku 7.

    Zrzut ekranu przedstawiający ekran

  5. Aby utworzyć wystąpienie usługi Azure SignalR:

    1. Wybierz pozycję Utwórz nowy w prawym środkowym rogu ekranu.

    2. Wypełnij pole Azure SignalR Service: Utwórz nowy ekran i wybierz pozycję Utwórz.

      Zrzut ekranu przedstawiający ekran

    3. Po wyświetleniu ekranu Konfigurowanie usługi Azure SignalR Service nowe wystąpienie zostanie wyświetlone na liście. Wybierz nowe wystąpienie na liście, a następnie wybierz pozycję Dalej.

  6. Wprowadź nazwę parametry połączenia lub wybierz wartość domyślną, a następnie wybierz, czy parametry połączenia przechowywany w lokalnym pliku wpisów tajnych, czy w usłudze Azure Key Vault.

    Zrzut ekranu przedstawiający ekran

  7. Na ekranie Podsumowanie zmian zostaną wyświetlone wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają ok, wybierz przycisk Zakończ.

    Zrzut ekranu przedstawiający ekran

  8. W Eksplorator rozwiązań kliknij dwukrotnie węzeł Usługi połączone, aby otworzyć kartę Usługi połączone. Połączenie zostanie wyświetlone w sekcji Zależności usługi:

    Zrzut ekranu przedstawiający sekcję

    Jeśli klikniesz trzy kropki obok dodanej zależności, zobaczysz różne opcje, takie jak Połącz , aby ponownie otworzyć kreatora i zmienić połączenie. Możesz również kliknąć trzy kropki w prawym górnym rogu okna, aby wyświetlić opcje uruchamiania zależności lokalnych, zmiany ustawień i nie tylko.

Następne kroki

Kontynuuj, postępując zgodnie z przewodnikiem Szybki start dla usługi Azure SignalR. Możesz pominąć początkową konfigurację, ponieważ już to zrobiono, i kontynuować pracę z sekcją Dodawanie usługi Azure SignalR do aplikacji internetowej. Używany kod różni się w zależności od używanej wersji ASP.NET Core, dlatego może być konieczne zmodyfikowanie kodu w samouczku, aby dopasować go do szablonu projektu, jeśli wersja ASP.NET Core nie jest zgodna z wersją używaną w przewodniku Szybki start.