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

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

Biblioteken för .NET-funktionshantering utökar ramverket med stöd för funktionsflaggan. Dessa bibliotek bygger på .NET-konfigurationssystemet. De integreras med App Configuration via dess .NET-konfigurationsprovider.

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• Visual Studio 2019
• .NET Framework 4.8

Skapa en App Configuration butik

1. Om du vill skapa ett nytt konfigurations Arkiv för appen loggar du in på Azure Portal. I det övre vänstra hörnet på Start sidan väljer du skapa en resurs. I rutan Sök på Marketplace anger du app-konfiguration och väljer RETUR.

   

2. Välj app-konfiguration från Sök resultaten och välj sedan skapa.

   

3. I fönstret skapa app-konfiguration anger du följande inställningar:

   Inställning	Föreslaget värde	Beskrivning
   Prenumeration	Din prenumeration	Välj den Azure-prenumeration du vill använda för att testa App Configuration. Om ditt konto bara har en prenumeration väljs den automatiskt och ingen prenumerations lista visas.
   Resursgrupp	AppConfigTestResources	Välj eller skapa en resurs grupp för din app Configuration Store-resurs. Den här gruppen är användbar för att organisera flera resurser som du kanske vill ta bort samtidigt genom att ta bort resurs gruppen. Mer information finns i använda resurs grupper för att hantera dina Azure-resurser.
   Resurs namn	Globalt unikt namn	Ange ett unikt resurs namn som ska användas för appens konfigurations Arkiv resurs. Namnet måste vara en sträng mellan 5 och 50 tecken och får bara innehålla siffror, bokstäver och - tecknet. Namnet får inte börja eller sluta med - specialtecknet.
   Plats	USA, centrala	Använd Plats till att ange den geografiska plats där appkonfigurationsarkivets resurs finns. För bästa prestanda skapar du resursen i samma region som andra komponenter i ditt program.
   Prisnivå	Kostnadsfri	Välj önskad pris nivå. Mer information finns på sidan med prissättning för app-konfiguration.

4. Välj Granska + skapa för att validera inställningarna.

5. Välj Skapa. Distributionen kan ta några minuter.

6. När distributionen är klar går du till appen konfigurations resurs. Välj Inställningar > Åtkomstnycklar. Anteckna den primära skrivskyddade nyckel anslutnings strängen. Du kommer att använda den här anslutnings strängen senare för att konfigurera programmet för att kommunicera med det app-konfigurations lager som du har skapat.

7. Välj Funktionshanteraren > + Lägg till för att lägga till en funktionsflagga med namnet Beta .

   

   Lämna label odefinierat tills nu.

Skapa en .NET-konsolapp

1. Starta Visual Studio och välj Arkiv > Ny > Project.

2. I Skapa ett nytt projekt filtrerar du på projekttypen Konsol och klickar på Konsolapp (.NET Framework). Klicka på Nästa.

3. I Konfigurera det nya projektet anger du ett projektnamn. Under Ramverk väljer du .NET Framework 4.8 eller senare. Klicka på Skapa.

Anslut till en App Configuration butik

1. 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. Om du inte hittar dem markerar du kryssrutan Inkludera förhandsversion.

   Microsoft.Extensions.DependencyInjection
   Microsoft.Extensions.Configuration.AzureAppConfiguration
   Microsoft.FeatureManagement
   

2. Ö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;
   

3. Uppdatera metoden Main för att ansluta App Configuration och ange alternativet så att UseFeatureFlags funktionsflaggor hämtas. Visa sedan ett meddelande om Beta funktionsflaggan ä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

1. Ange en miljövariabel med namnet ConnectionString till anslutningssträngen för App Configuration store. 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"
   

2. Starta Visual Studio så att ändringen börjar gälla.

3. 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 resurs gruppen som du skapade här för att undvika avgifter.

1. Logga in på Azure Portaloch välj resurs grupper.
2. I rutan Filtrera efter namn anger du namnet på din resurs grupp.
3. I listan resultat väljer du resurs gruppens namn för att se en översikt.
4. Välj Ta bort resursgrupp.
5. Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resurs gruppen som ska bekräftas och välj ta bort.

Efter en liten stund tas resurs gruppen 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 att dynamiskt uppdatera funktionsflaggor och andra konfigurationsvärden utan att starta om programmet fortsätter du till nästa självstudie.