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

Artikel
04/10/2023

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. In diesem Schnellstart werden Sie durch diese Option geführt.
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

Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto.
Ein App Configuration-Speicher. Erstellen Sie einen Speicher.
Visual Studio
.NET Framework 4.7.2 oder höher

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

Starten Sie Visual Studio, und wählen Sie Neues Projekt erstellen aus.
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.
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

Klicken Sie mit der rechten Maustaste auf Ihr Projekt, und wählen Sie NuGet-Pakete verwalten aus. Suchen Sie auf der Registerkarte Durchsuchen die folgenden NuGet-Pakete, und fügen Sie sie Ihrem Projekt hinzu.
- Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration, Version 1.0.0 oder höher
- Microsoft.Configuration.ConfigurationBuilders.Environment, Version 2.0.0 oder höher
- System.Configuration.ConfigurationManager, Version 4.6.0 oder höher

Aktualisieren Sie die Datei App.config Ihres Projekts wie folgt:

<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" connectionString="${ConnectionString}" 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="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
</appSettings>

Die Verbindungszeichenfolge Ihres App Configuration-Speichers wird aus der Umgebungsvariablen ConnectionString gelesen. Fügen Sie den Konfigurations-Generator Environment vor MyConfigStore in der Eigenschaft configBuilders des Abschnitts appSettings ein.

Ö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

Legen Sie eine Umgebungsvariable namens ConnectionString auf die Verbindungszeichenfolge mit schreibgeschütztem Schlüssel fest, die Sie bei der Erstellung Ihres App Configuration-Speichers erhalten haben.

Führen Sie bei Verwendung der Windows-Eingabeaufforderung den folgenden Befehl aus:
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Führen Sie bei Verwendung von Windows PowerShell den folgenden Befehl aus:
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Starten Sie Visual Studio, damit die Änderung wirksam wird.
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.

Melden Sie sich beim Azure-Portal an, und klicken Sie auf Ressourcengruppen.
Geben Sie im Feld Nach Name filtern den Namen Ihrer Ressourcengruppe ein.
Wählen Sie in der Ergebnisliste den Ressourcengruppennamen aus, um eine Übersicht anzuzeigen.
Wählen Sie die Option Ressourcengruppe löschen.
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