Freigeben über

Schnellstart: Erstellen einer .NET Framework-App mit Azure App Configuration

  • Artikel

Es gibt zwei Möglichkeiten, Azure App Configuration in eine .NET Framework-basierte Anwendung einzubinden.

  • Mit dem Konfigurations-Generator für App Configuration können App Configuration-Daten in App- Einstellungen geladen werden. Ihre Anwendung greift wie immer über ConfigurationManager auf die Konfiguration zu. Abgesehen von den Aktualisierungen der Dateien app.config und web.config müssen Sie keine weiteren Codeänderungen vornehmen. Dieser Schnellstart führt Sie durch diese Option.
  • Wie im .NET Framework vorgesehen, können die App-Einstellungen nur beim Neustart der Anwendung aktualisiert werden. Der .NET-Anbieter von App Configuration ist eine .NET Standard-Bibliothek. Sie unterstützt das dynamische Zwischenspeichern und Aktualisieren der Konfiguration ohne Anwendungsneustart. Wenn die dynamische Konfiguration für Sie wichtig ist und Sie bereit sind, Codeänderungen vorzunehmen, finden Sie in den Tutorials Anleitungen zur Implementierung der dynamischen Konfigurationsaktualisierung in einer .NET Framework-Konsolen-App oder einer ASP.NET-Web-App.

In diesem Schnellstart wird eine .NET Framework-Konsolen-App als Beispiel verwendet, aber das gleiche Verfahren gilt auch für eine ASP.NET Web Forms-/MVC-App.

Voraussetzungen

Hinzufügen eines Schlüssel-Wert-Paars

Fügen Sie dem App Configuration-Speicher den folgenden Schlüsselwert hinzu, und übernehmen Sie für Bezeichnung und Inhaltstyp die Standardwerte. Weitere Informationen zum Hinzufügen von Schlüssel-Wert-Paaren zu einem Speicher mithilfe des Azure-Portals oder der CLI finden Sie unter Erstellen eines Schlüssel-Wert-Paars.

Schlüssel Wert
TestApp:Settings:Message Daten aus Azure App Configuration

Erstellen einer .NET Framework-Konsolen-App

  1. Starten Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus.

  2. Filtern Sie unter Neues Projekt erstellen nach dem Projekttyp Konsole, und klicken Sie in der Projektvorlagenliste auf Konsolen-App (.NET Framework) mit C#. Klicken Sie auf Weiter.

  3. Geben Sie unter Neues Projekt konfigurieren einen Projektnamen ein. Wählen Sie unter Framework die Option .NET Framework 4.7.2 oder höher aus. Klicken Sie auf Erstellen.

Herstellen einer Verbindung mit einem App Configuration-Speicher

Verbinden Sie sich mit Ihrem App Configuration-Speicher entweder mithilfe von Microsoft Entra ID (empfohlen) oder mit einer Verbindungszeichenfolge.

  1. Klicken Sie mit der rechten Maustaste auf Ihr Projekt, und wählen Sie NuGet-Pakete verwalten aus. Suchen Sie auf der Registerkarte Durchsuchen die nach der aktuellen stabilen Versionen der folgenden NuGet-Pakete, und fügen Sie sie Ihrem Projekt hinzu.

    • Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration
    • Microsoft.Configuration.ConfigurationBuilders.Environment
    • System.Configuration.ConfigurationManager

  2. Aktualisieren Sie die Datei App.config Ihres Projekts wie folgt. Sie können eine Verbindung mit Ihrem App Configuration-Speicher entweder mithilfe von Microsoft Entra ID (empfohlen) oder mit einer Verbindungszeichenfolge herstellen.

    DefaultAzureCredential wird standardmäßig für die Authentifizierung beim App Configuration-Speicher verwendet. Befolgen Sie die Anweisungen, um Ihre Anmeldeinformationen der Rolle App Configuration-Datenleser zuzuweisen. Achten Sie darauf, ausreichend Zeit für die Verteilung der Berechtigung zu warten, bevor Sie Ihre Anwendung ausführen.

    <configSections>
    <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
</configSections>

<configBuilders>
    <builders>
        <add name="MyConfigStore" mode="Greedy" endpoint="${Endpoint}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
        <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
    </builders>
</configBuilders>

<appSettings configBuilders="Environment,MyConfigStore">
    <add key="AppName" value="Console App Demo" />
    <add key="Endpoint" value ="Set via an environment variable - for example, dev, test, staging, or production endpoint." />
</appSettings>

    Der Endpunktwert Ihres App Configuration-Speichers wird aus der Umgebungsvariablen Endpoint gelesen. Sie können auch den Konfigurations-Generator Environment vor MyConfigStore in der Eigenschaft configBuilders des Abschnitts appSettings einfügen.

  3. Öffnen Sie die Datei Program.cs, und aktualisieren Sie die Main-Methode für die Verwendung von App Configuration, indem Sie ConfigurationManager aufrufen.

    static void Main(string[] args)
{
    string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];

    Console.WriteLine(message);
    Console.ReadKey();
}

Erstellen und Ausführen der App

  1. Legen Sie eine Umgebungsvariable fest.

    Legen Sie eine Umgebungsvariable Endpoint auf den Endpunkt Ihres App Configuration-Speichers fest, den Sie in der Übersicht Ihres Speichers im Azure-Portal finden.

    Führen Sie bei Verwendung einer Windows-Eingabeaufforderung den folgenden Befehl aus, und starten Sie die Eingabeaufforderung neu, damit die Änderung wirksam wird:

    setx Endpoint "<endpoint-of-your-app-configuration-store>"

    Wenn Sie PowerShell verwenden, und führen Sie den folgenden Befehl aus:

    $Env:Endpoint = "<endpoint-of-your-app-configuration-store>"

    Führen Sie bei Verwendung von macOS oder Linux den folgenden Befehl aus:

    export Endpoint='<endpoint-of-your-app-configuration-store>'

  2. Starten Sie Visual Studio, damit die Änderung wirksam wird.

  3. Drücken Sie STRG+F5, um die Konsolen-App zu erstellen und auszuführen. In der Konsole sollte die Meldung der App Configuration-Ausgabe angezeigt werden.

Bereinigen von Ressourcen

Wenn Sie die in diesem Artikel erstellten Ressourcen nicht mehr verwenden möchten, löschen Sie die erstellte Ressourcengruppe, um Kosten zu vermeiden.

Wichtig

Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden. Die Ressourcengruppe und alle darin enthaltenen Ressourcen werden unwiderruflich gelöscht. Achten Sie daher darauf, dass Sie nicht versehentlich die falsche Ressourcengruppe oder die falschen Ressourcen löschen. Falls Sie die Ressourcen für diesen Artikel in einer Ressourcengruppe erstellt haben, die andere beizubehaltende Ressourcen enthält, löschen Sie die Ressourcen einzeln über den entsprechenden Bereich, statt die Ressourcengruppe zu löschen.

  1. Melden Sie sich beim Azure-Portal an, und klicken Sie auf Ressourcengruppen.
  2. Geben Sie im Feld Nach Name filtern den Namen Ihrer Ressourcengruppe ein.
  3. Wählen Sie in der Ergebnisliste den Ressourcengruppennamen aus, um eine Übersicht anzuzeigen.
  4. Wählen Sie die Option Ressourcengruppe löschen.
  5. Sie werden aufgefordert, das Löschen der Ressourcengruppe zu bestätigen. Geben Sie zur Bestätigung den Namen Ihrer Ressourcengruppe ein, und klicken Sie auf Löschen.

Daraufhin werden die Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht.

Nächste Schritte

In diesem Schnellstart haben Sie einen neuen App Configuration-Speicher erstellt und mit einer .NET Framework-Konsolen-App verwendet. Fahren Sie mit dem nächsten Tutorial fort, um zu erfahren, wie Sie Ihre .NET Framework-App für das dynamische Aktualisieren der Konfigurationseinstellungen konfigurieren.

Aktivieren der dynamischen Konfiguration in einer .NET Framework-App

Aktivieren der dynamischen Konfiguration in ASP.NET-Web-App