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

I den här snabbstarten införlivar du Конфигурация приложений Azure i en .NET Framework app för att skapa en implementering av funktionshantering från slutpunkt till slutpunkt. Du kan använda Конфигурация приложений-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 Конфигурация приложений via dess .NET-konfigurationsprovider.

Krav

Skapa en Конфигурация приложений butik

  1. Logga in på Azure-Portal om du vill skapa en ny Конфигурация приложений butik.

  2. I det övre vänstra hörnet på startsidan väljer du Skapa en resurs.

  3. I rutan Söktjänster och Marketplace anger du Конфигурация приложений och väljer Retur.

    Skärmbild som visar sidan Sök efter Конфигурация приложений.

  4. Välj Конфигурация приложений i sökresultaten och välj sedan Skapa.

    Skärmbild som visar sidan Skapa.

  5. I fönstret Skapa Конфигурация приложений 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 det automatiskt och prenumerationslistan visas inte.
    Resursgrupp AppConfigTestResources Välj eller skapa en resursgrupp för din Конфигурация приложений lagringsresurs. Den här gruppen är användbar för att organisera flera resurser som du kanske vill ta bort samtidigt genom att ta bort resursgruppen. Mer information finns i Använda resursgrupper för att hantera dina Azure-resurser.
    Resursnamn Globalt unikt namn Ange ett unikt resursnamn som ska användas för resursen Конфигурация приложений store. Namnet måste vara en sträng mellan 5 och 50 tecken och får endast innehålla siffror, bokstäver och - tecken. Namnet får inte börja eller sluta med - tecknet.
    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 prisnivå. Mer information finns på sidan Конфигурация приложений prissättning.
  6. Välj Granska + skapa för att verifiera inställningarna.

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

  8. När distributionen är klar går du till den Конфигурация приложений resursen. Välj Inställningar>Åtkomstnycklar. Anteckna den primära skrivskyddade nyckeln συμβολοσειρά σύνδεσης. Du kommer att använda den här συμβολοσειρά σύνδεσης senare för att konfigurera programmet så att det kommunicerar med Конфигурация приложений store som du skapade.

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

    Aktivera funktionsflagga med namnet Beta

    Lämna label odefinierade för tillfället.

Skapa en .NET-konsolapp

  1. Starta Visual Studio och välj Arkiv>Nytt>projekt.

  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 Framework väljer du .NET Framework 4.8 eller senare. Klicka på Skapa.

Ansluta till en Конфигурация приложений 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.

    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. Main Uppdatera metoden för att ansluta till Конфигурация приложений 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

  1. Ange en miljövariabel med namnet ConnectionString till συμβολοσειρά σύνδεσης för ditt Конфигурация приложений-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"
    
  2. Starta om Visual Studio så att ändringen börjar gälla.

  3. Tryck på Ctrl + F5 för att skapa och köra konsolappen.

    App med funktionsflagga aktiverad

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.

  1. Logga in på Azure-Portal och välj Resursgrupper.
  2. I rutan Filtrera efter namn anger du namnet på resursgruppen.
  3. I resultatlistan väljer du resursgruppens 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å 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 Конфигурация приложений 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.