Udostępnij za pośrednictwem


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

W Visual Studio możesz połączyć którąkolwiek z poniższych z usługą Azure SignalR, używając funkcji Usługi Połączone:

  • Aplikacja konsolowa .NET Framework
  • model ASP.NET —View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (w tym aplikacja konsolowa, WPF, Windows Forms, biblioteka klas)
  • Rola usługi roboczej platformy .NET Core
  • Azure Functions
  • Aplikacja platformy uniwersalnej 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.

Warunki 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 Eksploratorze rozwiązań kliknij prawym przyciskiem myszy węzeł Usługi Połączone, a następnie z menu kontekstowego wybierz pozycję Dodaj Połączoną Usługę.

    Jeśli nie widzisz węzła Connected Services, wybierz pozycję Projekt>Connected Services>Dodaj.

  3. W zakładce Usługi Połączone wybierz ikonę + w przypadku Zależności Usługi.

    Dodaj zależność usługi

  4. Na stronie Dodaj zależność wybierz Azure SignalR Service.

    Dodaj usługę Azure SignalR Service

    Jeśli jeszcze nie zalogowałeś się, zaloguj się do swojego konta platformy Azure. Jeśli nie masz konta Azure, możesz zarejestrować się na bezpłatną wersję próbną.

  5. Na ekranie Konfigurowanie usługi Azure SignalR wybierz istniejący składnik usługi Azure SignalR i 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 ekran Azure SignalR Service: Utwórz nowy i wybierz Utwórz.

      nowe wystąpienie usługi Azure SignalR Service

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

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

    Określ parametry połączenia

  8. Na ekranie Podsumowanie zmian są wyświetlane wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają OK, wybierz opcję Zakończ.

    Podsumowanie zmian

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

    zależności usługi

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

Notatka

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ł Połączone usługi, a następnie z menu kontekstowego wybierz pozycję 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ług połączonych, wybierz Projekt>Connected Services>Dodaj.

  3. Wybierz Azure SignalR Service. Zostanie wyświetlona strona Połącz z zależnością.

    Zrzut ekranu pokazujący łączenie się 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 Azure, możesz zarejestrować się na bezpłatną wersję próbną.

  4. Wybierz istniejący składnik usługi Azure SignalR i 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 nową w prawym środkowym rogu ekranu.

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

      Zrzut ekranu pokazujący ekran

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

  6. Wprowadź nazwę ustawienia połączenia lub zaakceptuj wartość domyślną.

    zrzut ekranu przedstawiający ekran

    Uwaga

    Aby zwiększyć bezpieczeństwo, w programie Visual Studio 17.12 lub nowszym ten krok tworzy nazwę ustawienia połączenia; poprzednie wersje tworzą parametry połączenia. Parametry połączenia przechowywane w lokalnym systemie plików mogą prowadzić do zagrożenia bezpieczeństwa, jeśli są przypadkowo uwidocznione.

  7. Kliknij pozycję Dodatkowe ustawienia i wybierz, czy chcesz przechowywać informacje o połączeniu w lokalnym pliku wpisów tajnych, czy w usłudze Azure Key Vault.

    Zrzut ekranu przedstawiający dodatkowe ustawienia z opcjami przechowywania ustawienia połączenia.

  8. Na ekranie Podsumowanie zmian są wyświetlane wszystkie modyfikacje wprowadzone w projekcie w przypadku ukończenia procesu. Jeśli zmiany wyglądają OK, wybierz opcję Zakończ.

    zrzut ekranu przedstawiający ekran

  9. W Eksploratorze 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 na trzy kropki obok dodanej zależności, pojawią się różne opcje, takie jak Connect, 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.