Snabbstart: Lägga till funktionsflaggor i en .NET Framework app

Artikel
03/30/2023

I den här snabbstarten införlivar du Azure App Configuration i en .NET Framework-app för att skapa en implementering av funktionshantering från slutpunkt till slutpunkt. Du kan använda App Configuration-tjänsten för att centralt lagra alla dina funktionsflaggor och kontrollera deras tillstånd.

.NET-funktionshanteringsbiblioteken utökar ramverket med stöd för funktionsflagga. De här biblioteken bygger på .NET-konfigurationssystemet. De integreras med App Configuration via dess .NET-konfigurationsprovider.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Skapa en kostnadsfritt.
En App Configuration butik. Skapa en butik.
Visual Studio 2019
.NET Framework 4.8

Lägg till en funktionsflagga

Lägg till en funktionsflagga med namnet Beta i App Configuration store och lämna Etikett och Beskrivning med sina standardvärden. Mer information om hur du lägger till funktionsflaggor i ett arkiv med hjälp av Azure Portal eller CLI finns i Skapa en funktionsflagga.

Skapa en .NET-konsolapp

Starta Visual Studio och välj Arkiv>Nytt>projekt.
I Skapa ett nytt projekt filtrerar du på projekttypen Konsol och klickar på Konsolapp (.NET Framework). Klicka på Nästa.
I Konfigurera det nya projektet anger du ett projektnamn. Under Framework väljer du .NET Framework 4.8 eller senare. Klicka på Skapa.

Ansluta till en App Configuration butik

Högerklicka på projektet och välj Hantera NuGet-paket. På fliken Bläddra söker du efter och lägger till följande NuGet-paket i projektet.
```
Microsoft.Extensions.DependencyInjection
Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement
```

Öppna Program.cs och lägg till följande instruktioner:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;
using Microsoft.FeatureManagement;
using System.Threading.Tasks;

Main Uppdatera metoden för att ansluta till App Configuration och ange UseFeatureFlags alternativet så att funktionsflaggor hämtas. Visa sedan ett meddelande om funktionsflaggan Beta är aktiverad.

    public static async Task Main(string[] args)
    {         
        IConfigurationRoot configuration = new ConfigurationBuilder()
            .AddAzureAppConfiguration(options =>
            {
                options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                       .UseFeatureFlags();
            }).Build();

        IServiceCollection services = new ServiceCollection();

        services.AddSingleton<IConfiguration>(configuration).AddFeatureManagement();

        using (ServiceProvider serviceProvider = services.BuildServiceProvider())
        {
            IFeatureManager featureManager = serviceProvider.GetRequiredService<IFeatureManager>();

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

        Console.WriteLine("Hello World!");
        Console.WriteLine("Press any key to continue ...");
        Console.Read();
    }

Skapa och köra appen lokalt

Ange en miljövariabel med namnet ConnectionString till anslutningssträngen för ditt App Configuration-arkiv. Om du använder Windows-kommandotolken kör du följande kommando:
```
    setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Om du använder Windows PowerShell kör du följande kommando:
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Starta om Visual Studio så att ändringen börjar gälla.
Tryck på Ctrl + F5 för att skapa och köra konsolappen.

Rensa resurser

Om du inte vill fortsätta använda resurserna som skapats i den här artikeln tar du bort den resursgrupp som du skapade här för att undvika avgifter.

Viktigt

Att ta bort en resursgrupp kan inte ångras. Resursgruppen och alla resurser i den tas bort permanent. Se till att du inte tar bort fel resursgrupp eller resurser av misstag. Om du har skapat resurserna för den här artikeln i en resursgrupp som innehåller andra resurser som du vill behålla tar du bort varje resurs individuellt från respektive fönster i stället för att ta bort resursgruppen.

Logga in på Azure Portal och välj Resursgrupper.
I rutan Filtrera efter namn anger du namnet på resursgruppen.
I resultatlistan väljer du resursgruppens namn för att se en översikt.
Välj Ta bort resursgrupp.
Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resursgruppen för att bekräfta och välj Ta bort.

Efter en liten stund tas resursgruppen och alla dess resurser bort.

Nästa steg

I den här snabbstarten skapade du en funktionsflagga i App Configuration och använde den med en .NET Framework konsolapp. Om du vill lära dig hur du dynamiskt uppdaterar funktionsflaggor och andra konfigurationsvärden utan att starta om programmet fortsätter du till nästa självstudie.

Aktivera dynamisk konfiguration