Teilen über

Schnellstart: Hinzufügen von Featureflags zu einer .NET-/.NET Framework-Konsolen-App

In dieser Schnellstartanleitung integrieren Sie die Azure-App-Konfiguration in eine .NET- oder .NET Framework-Konsolen-App, um eine End-to-End-Implementierung der Featureverwaltung zu erstellen. Mit App Configuration können Sie alle Featureflags zentral speichern und ihren jeweiligen Zustand steuern.

Die .NET-Featureverwaltungsbibliotheken erweitern .NET, indem Unterstützung für Featurekennzeichen bereitgestellt wird. Diese Bibliotheken bauen auf dem .NET-Konfigurationssystem auf. Über ihren .NET-Konfigurationsanbieter lassen sie sich in App Configuration integrieren.

Voraussetzungen

Hinzufügen eines Featureflags

Fügen Sie dem App Configuration-Speicher ein Featureflag mit dem Namen Beta hinzu, und behalten Sie die Standardwerte für Bezeichnung und Beschreibung bei. Weitere Informationen zum Hinzufügen von Featurekennzeichnungen zu einem Speicher mithilfe des Azure-Portals oder der Azure CLI finden Sie unter Erstellen eines Featureflags.

Screenshot des Dialogfelds zum Erstellen einer neuen Featurekennzeichnung im Azure-Portal. Die Felder für Name und Schlüssel enthalten

Konfigurieren von Zugriffseinstellungen

Die App, die Sie in dieser Schnellstartanleitung erstellen, stellt eine Verbindung mit Ihrem App-Konfigurationsspeicher für den Zugriff auf Ihre Featurekennzeichnungseinstellungen bereit. Um eine Verbindung mit der App-Konfiguration herzustellen, kann Ihre App die Microsoft Entra-ID oder eine Verbindungszeichenfolge verwenden. Microsoft Entra ID ist der empfohlene Ansatz.

Zuweisen einer App Configuration-Datenrolle

Standardmäßig verwendet DefaultAzureCredential die von Ihnen erstellte App die Authentifizierung bei Ihrem App Configuration Store. DefaultAzureCredential ist eine Kette von Token-Zugangsdaten. Damit die Autorisierung funktioniert, müssen Sie der Rolle " App-Konfigurationsdatenleser " die von Ihrer App verwendeten Anmeldeinformationen erteilen. Anweisungen finden Sie unter Authentifizierung mit Tokenanmeldeinformationen. Lassen Sie ausreichend Zeit, damit sich die Rollenzuweisung ausbreiten kann, bevor Sie Ihre App ausführen.

Festlegen einer Umgebungsvariable

Ihre App verwendet eine Umgebungsvariable, um die Verbindung mit der App-Konfiguration herzustellen. Verwenden Sie einen der folgenden Befehle, um eine Umgebungsvariable namens Endpoint auf den Endpunkt Ihres App-Konfigurationsspeichers festzulegen.

  • Wenn Sie die Eingabeaufforderung verwenden, führen Sie den folgenden Befehl aus:

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

    Schließen Sie die Eingabeaufforderung und öffnen Sie sie erneut, um die Änderung wirksam werden zu lassen. Stellen Sie sicher, dass die Umgebungsvariable festgelegt wird, indem Sie ihren Wert in die Konsole drucken.

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

    [System.Environment]::SetEnvironmentVariable("Endpoint", "<endpoint-of-your-app-configuration-store>", "User")

Erstellen einer Konsolen-App

Führen Sie die folgenden Schritte aus, um Visual Studio zum Erstellen eines neuen Konsolen-App-Projekts zu verwenden.

  1. Öffnen Sie Visual Studio. Wenn sie bereits ausgeführt wird, schließen Sie sie, und öffnen Sie sie erneut, damit sie die Umgebungsvariable erkennt, die Sie im vorherigen Abschnitt festgelegt haben.

  2. Wählen Sie in Visual Studio "Datei>Neu>Projekt" aus.

  3. Geben Sie im Dialogfeld " Neues Projekt erstellen " die Konsole in das Suchfeld ein.

    • Wenn Sie eine .NET-App erstellen möchten, wählen Sie "Konsolen-App" und dann "Weiter" aus.
    • Wenn Sie eine .NET Framework-App erstellen möchten, wählen Sie "Konsolen-App (.NET Framework)" und dann "Weiter" aus.

  4. Geben Sie im Dialogfeld " Neues Projekt konfigurieren " einen Projektnamen ein.

    • Wenn Sie eine .NET-App erstellen möchten, wählen Sie "Weiter" aus, um das Dialogfeld "Zusätzliche Informationen " zu öffnen. Wählen Sie in diesem Dialogfeld ein .NET Framework aus, deaktivieren Sie das Kontrollkästchen " Anweisungen der obersten Ebene nicht verwenden ", und wählen Sie dann " Erstellen" aus.
    • Wenn Sie eine .NET Framework-App erstellen möchten, wählen Sie .NET Framework 4.7.2 oder eine höhere Version unter Framework aus, und wählen Sie dann "Erstellen" aus.

Verwenden des Featureflags

Führen Sie die folgenden Schritte aus, um die Featurekennzeichnung in Ihrer App zu verwenden.

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf Ihr Projekt, und wählen Sie dann "NuGet-Pakete verwalten" aus.

  2. Suchen Sie auf der Registerkarte " Durchsuchen " nach den neuesten stabilen Versionen der folgenden NuGet-Pakete, und fügen Sie sie ihrem Projekt hinzu:

    • Microsoft.Extensions.Configuration.AzureAppConfiguration
    • Microsoft.FeatureManagement
    • Azure.Identity

  3. Öffnen Sie Program.cs , und fügen Sie am Anfang der Datei die folgenden Anweisungen hinzu.

    using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;
using Microsoft.FeatureManagement;
using Azure.Identity;

  4. Wie in den folgenden Codeblöcken gezeigt, aktualisieren Sie Program.cs , indem Sie drei Änderungen vornehmen:

    • Um Featurekennzeichnungen aus der App-Konfiguration zu laden, fügen Sie einen Aufruf der UseFeatureFlags Methode hinzu.
    • Um Featurekennzeichnungen aus der Konfiguration zu lesen, erstellen Sie eine Instanz von FeatureManager.
    • Zeige eine Meldung an, wenn das Beta-Feature-Flag aktiviert ist.

    .NET

    IConfiguration configuration = new ConfigurationBuilder()
    .AddAzureAppConfiguration(options =>
    {
        string endpoint = Environment.GetEnvironmentVariable("Endpoint");
        options.Connect(new Uri(endpoint), new DefaultAzureCredential())
               .UseFeatureFlags();
    }).Build();

var featureManager = new FeatureManager(
    new ConfigurationFeatureDefinitionProvider(configuration));

if (await featureManager.IsEnabledAsync("Beta"))
{
    Console.WriteLine("Welcome to the beta!");
}

Console.WriteLine("Hello World!");

    .NET Framework

    public static async Task Main(string[] args)
{         
    IConfiguration configuration = new ConfigurationBuilder()
        .AddAzureAppConfiguration(options =>
        {
            string endpoint = Environment.GetEnvironmentVariable("Endpoint");
            options.Connect(new Uri(endpoint), new DefaultAzureCredential())
                   .UseFeatureFlags();
        }).Build();

    var featureManager = new FeatureManager(
        new ConfigurationFeatureDefinitionProvider(configuration));

    if (await featureManager.IsEnabledAsync("Beta"))
    {
        Console.WriteLine("Welcome to the beta!");
    }

    Console.WriteLine("Hello World!");
}

Lokales Erstellen und Ausführen der App

  1. Wählen Sie in Visual Studio STRG+F5 aus, um die Anwendung zu erstellen und auszuführen. Die folgende Ausgabe sollte in der Konsole angezeigt werden.

    Screenshot eines Eingabeaufforderungsfensters, das die Ausgabe der App enthält. Die Ausgabe enthält den Text Hello World!

  2. Melden Sie sich beim Azure-Portal an. Wählen Sie "Alle Ressourcen" und dann Ihren App-Konfigurationsspeicher aus.

  3. Wählen Sie Feature-Manager aus, und suchen Sie das Featureflag Beta. Aktivieren Sie die Umschaltfläche "Aktiviert ", um die Kennzeichnung zu aktivieren.

  4. Erneutes Ausführen der Anwendung Die Betanachricht sollte in der Konsole angezeigt werden.

    Screenshot eines Eingabeaufforderungsfensters, das die Ausgabe der App enthält. Die Ausgabe enthält den Text Willkommen in der Betaversion! und Hallo Welt!

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 ein Featureflag in App Configuration erstellt und mit einer Konsolen-App verwendet. Informationen zum dynamischen Aktualisieren von Featurekennzeichnungen und anderen Konfigurationswerten ohne Neustart der Anwendung finden Sie in den folgenden Lernprogrammen:

Verwenden der dynamischen Konfiguration in einer .NET-App

Verwenden der dynamischen Konfiguration in einer .NET Framework-App

Informationen zum Aktivieren der Featureverwaltungsfunktion für andere Arten von Apps finden Sie in den folgenden Schnellstarts:

Hinzufügen von Featurekennzeichnungen zu einer ASP.NET Core-App

Hinzufügen von Featurekennzeichnungen zu einem .NET-Hintergrunddienst

Die vollständige Funktionsausführung der .NET-Featureverwaltungsbibliothek finden Sie im folgenden Dokument:

.NET-Featureverwaltung

  • Last updated on