Freigeben über


Hinzufügen von Azure SignalR mithilfe von Visual Studio Connected Services

Mit Visual Studio können Sie eine der folgenden Verbindungen mit dem Azure SignalR-Dienst herstellen, indem Sie das Feature Connected Services verwenden:

  • .NET Framework-Konsolen-App
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (einschließlich Konsolen-App, WPF, Windows Forms, Klassenbibliothek)
  • .NET Core-Workerrolle
  • Azure-Funktionen
  • Universelle Windows-Plattform-App
  • Xamarin
  • Cordova

Die funktion des verbundenen Diensts fügt dem Projekt alle erforderlichen Verweise und Verbindungscode hinzu und ändert die Konfigurationsdateien entsprechend.

Voraussetzungen

Mit Azure SignalR über Connected Services verbinden

  1. Öffnen Sie Ihr Projekt in Visual Studio.

  2. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü Verbundenen Dienst hinzufügen aus.

    Wenn der Knoten Verbundene Dienste nicht angezeigt wird, wählen Sie Projekt>Verbundene Dienste>Hinzufügen aus.

  3. Wählen Sie auf der Registerkarte Verbundene Dienste das Symbol +für Dienstabhängigkeitenaus.

    Hinzufügen von Dienstabhängigkeiten

  4. Wählen Sie auf der Seite Abhängigkeit hinzufügen die Option Azure SignalR Service aus.

    Hinzufügen von Azure SignalR Service-

    Wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  5. Wählen Sie im Bildschirm Azure SignalR Service konfigurieren eine vorhandene Azure SignalR Service-Komponente und dann Weiter aus.

    Wenn Sie eine neue Komponente erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Fahren Sie andernfalls mit Schritt 7 fort.

    Herstellen einer Verbindung mit einer vorhandenen Azure SignalR-Komponente

  6. So erstellen Sie eine Azure SignalR-Dienstinstanz:

    1. Wählen Sie Erstellen einer neuen Azure SignalR Service-Instanz unten auf dem Bildschirm aus.

    2. Füllen Sie den Bildschirm Azure SignalR Service: Neu erstellen aus, und wählen Sie Erstellen aus.

      Neue Azure SignalR Service-Instanz

    3. Wenn der Bildschirm Azure SignalR Service konfigurieren angezeigt wird, befindet sich die neue Instanz in der Liste. Wählen Sie die neue Instanz in der Liste aus, und wählen Sie Weiteraus.

  7. Geben Sie einen Verbindungszeichenfolgennamen ein, oder wählen Sie die Standardeinstellung aus, und wählen Sie aus, ob die Verbindungszeichenfolge in einer lokalen geheimen Datei oder in Azure Key Vaultgespeichert werden soll.

    Verbindungszeichenfolge angeben

  8. Die Zusammenfassung der Änderungen Bildschirm zeigt alle Änderungen an, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abgeschlossen haben. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

    Zusammenfassung der Änderungen

  9. Die Verbindung wird unter dem Abschnitt Dienstabhängigkeiten der Registerkarte Verbundene Dienste angezeigt.

    Dienstabhängigkeiten

Verbindung mit Azure SignalR über verbundene Dienste herstellen

Anmerkung

Bei .NET Framework-Projekten unterscheidet sich die Benutzeroberfläche für verbundene Dienste geringfügig. Um die Unterschiede zu sehen, vergleichen Sie sie mit der Visual Studio 2019-Version dieser Seite.

  1. Öffnen Sie Ihr Projekt in Visual Studio.

  2. Klicken Sie im Projektmappen-Explorermit der rechten Maustaste auf den Knoten Verbundene Dienste, und wählen Sie im Kontextmenü Hinzufügen aus, um das Menü der verfügbaren Dienste zu öffnen.

    Screenshot mit Optionen des Kontextmenüs der verbundenen Dienste.

    Wenn der Knoten Verbundene Dienste nicht angezeigt wird, wählen Sie Projekt>Verbundene Dienste>Hinzufügen aus.

  3. Wählen Sie Azure SignalR Serviceaus. Die Seite Mit Abhängigkeit verbinden wird angezeigt.

    Screenshot, der die Verbindung mit einer Abhängigkeit für Azure SignalR zeigt.

    Wenn Sie noch nicht angemeldet sind, melden Sie sich bei Ihrem Azure-Konto an. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversionregistrieren.

  4. Wählen Sie eine vorhandene Azure SignalR-Komponente aus, und wählen Sie Nextaus.

    Wenn Sie eine neue Komponente erstellen müssen, fahren Sie mit dem nächsten Schritt fort. Fahren Sie andernfalls mit Schritt 7 fort.

    Screenshot: Bildschirm „Herstellen einer Verbindung mit einer vorhandenen Azure SignalR-Komponente“

  5. So erstellen Sie eine Azure SignalR-Dienstinstanz:

    1. Wählen Sie in der Mitte rechts auf dem Bildschirm Neu erstellen aus.

    2. Füllen Sie den Bildschirm Azure SignalR Service: Neu erstellen aus, und wählen Sie Erstellen aus.

      Screenshot: Bildschirm „Neue Azure SignalR Service-Instanz“

    3. Wenn der Bildschirm Azure SignalR Service konfigurieren angezeigt wird, befindet sich die neue Instanz in der Liste. Wählen Sie die neue Instanz in der Liste aus, und wählen Sie Weiteraus.

  6. Geben Sie einen Namen für die Verbindungseinstellung ein, oder akzeptieren Sie den Standardwert.

    Screenshot: Bildschirm „Verbindungszeichenfolge angeben“

    Anmerkung

    Um die Sicherheit zu verbessern, erstellt dieser Schritt in Visual Studio 17.12 und höher einen Verbindungseinstellungsnamen. In früheren Versionen wird eine Verbindungszeichenfolge erstellt. Verbindungszeichenfolgen, die im lokalen Dateisystem gespeichert sind, können zu einem Sicherheitsrisiko führen, wenn sie versehentlich verfügbar gemacht werden.

  7. Klicken Sie auf Zusätzliche Einstellungen und wählen Sie aus, ob die In einer lokalen geheimen Datei gespeicherten Verbindungsinformationen oder in Azure Key Vaultgespeichert werden sollen.

    Screenshot mit zusätzlichen Einstellungen mit Optionen zum Speichern der Verbindungseinstellung.

  8. Die Zusammenfassung der Änderungen Bildschirm zeigt alle Änderungen an, die an Ihrem Projekt vorgenommen werden, wenn Sie den Vorgang abgeschlossen haben. Wenn die Änderungen korrekt sind, wählen Sie Fertig stellen aus.

    Screenshot des Bildschirms

  9. Doppelklicken Sie im Projektmappen-Explorer auf den Knoten Verbundene Dienste, um die Registerkarte Connected Services zu öffnen. Die Verbindung wird unter dem Abschnitt Dienstabhängigkeiten angezeigt:

    Screenshot mit dem Abschnitt

    Wenn Sie neben der hinzugefügten Abhängigkeit auf die drei Punkte klicken, werden verschiedene Optionen wie Connect angezeigt, um den Assistenten erneut zu öffnen und die Verbindung zu ändern. Sie können auch oben rechts im Fenster auf die drei Punkte klicken, um Optionen anzuzeigen, um lokale Abhängigkeiten zu starten, Einstellungen zu ändern und vieles mehr.

Nächste Schritte

Fahren Sie fort, indem Sie den Azure SignalR-Schnellstart befolgen. Sie können die anfängliche Einrichtung überspringen, da Sie dies bereits getan haben, und fahren Sie mit dem Abschnitt Hinzufügen von Azure SignalR zur Web-Appfort. Der von Ihnen verwendete Code variiert je nach Ihrer Version von ASP.NET Core. Möglicherweise müssen Sie den Code im Lernprogramm entsprechend Ihrer Projektvorlage ändern, wenn Ihre ASP.NET Core-Version nicht mit der in der Schnellstartanleitung verwendeten Version übereinstimmt.