Szybki start: dodawanie flag funkcji do aplikacji konsolowej .NET/.NET Framework

W tym przewodniku Szybki start uwzględnisz aplikacja systemu Azure Configuration w aplikacji konsolowej platformy .NET, aby utworzyć kompleksową implementację zarządzania funkcjami. Za pomocą usługi App Configuration można centralnie przechowywać wszystkie flagi funkcji i kontrolować ich stany.

Biblioteki zarządzania funkcjami platformy .NET rozszerzają platformę z obsługą flag funkcji. Te biblioteki są oparte na systemie konfiguracji platformy .NET. Integrują się z usługą App Configuration za pośrednictwem dostawcy konfiguracji platformy .NET.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz je bezpłatnie.
• Magazyn usługi App Configuration. Utwórz magazyn.
• Program Visual Studio
• Zestaw .NET SDK 6.0 lub nowszy dla aplikacji konsolowej platformy .NET.
• Program .NET Framework 4.7.2 lub nowszy dla aplikacji konsolowej .NET Framework.

Dodawanie flagi funkcji

Dodaj flagę funkcji o nazwie Beta do sklepu App Configuration i pozostaw pole Etykieta i Opis z ich wartościami domyślnymi. Aby uzyskać więcej informacji na temat dodawania flag funkcji do magazynu przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia, przejdź do tematu Tworzenie flagi funkcji.

Tworzenie aplikacji konsolowej

Za pomocą programu Visual Studio można utworzyć nowy projekt aplikacji konsolowej.

1. Uruchom program Visual Studio i wybierz pozycję Plik>nowy>projekt.

2. W obszarze Tworzenie nowego projektu przefiltruj typ projektu Konsola i wybierz pozycję Aplikacja konsolowa. Jeśli chcesz utworzyć aplikację .NET Framework, zamiast tego wybierz pozycję Aplikacja konsolowa (.NET Framework). Kliknij przycisk Dalej.

3. W obszarze Konfigurowanie nowego projektu wprowadź nazwę projektu. Jeśli tworzysz aplikację .NET Framework, wybierz pozycję .NET Framework 4.7.2 lub nowszą w obszarze Framework. Kliknij pozycję Utwórz.

Używanie flagi funkcji

1. Kliknij projekt prawym przyciskiem myszy i wybierz polecenie Zarządzaj pakietami NuGet. Na karcie Przeglądaj wyszukaj i dodaj do projektu najnowsze stabilne wersje następujących pakietów NuGet.

   Microsoft Entra ID (zalecane)

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

   Parametry połączenia

   Microsoft.Extensions.Configuration.AzureAppConfiguration
   Microsoft.FeatureManagement
   

2. Otwórz Program.cs i dodaj następujące instrukcje.

   Microsoft Entra ID (zalecane)

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

   Parametry połączenia

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

3. Zaktualizuj plik Program.cs i dodaj wywołanie UseFeatureFlags metody w celu załadowania flag funkcji z usługi App Configuration. Następnie utwórz flagi FeatureManager funkcji do odczytu z konfiguracji. Na koniec wyświetl komunikat, jeśli flaga funkcji beta jest włączona.

   Możesz połączyć się ze swoim magazynem App Configuration przy użyciu identyfikatora Entra firmy Microsoft (zalecane) lub parametry połączenia.

   Microsoft Entra ID (zalecane)

   Domyślnie używasz elementu DefaultAzureCredential do uwierzytelniania w magazynie App Configuration. Postępuj zgodnie z instrukcjami, aby przypisać poświadczenia roli Czytelnik danych konfiguracji aplikacji. Przed uruchomieniem aplikacji należy zezwolić na wystarczający czas na propagację uprawnień.

   .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!");
   }
   

   Parametry połączenia

   .NET

   IConfiguration configuration = new ConfigurationBuilder()
       .AddAzureAppConfiguration(options =>
       {
           options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                  .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 =>
           {
               options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                      .UseFeatureFlags();
           }).Build();
   
       var featureManager = new FeatureManager(
           new ConfigurationFeatureDefinitionProvider(configuration));
   
       if (await featureManager.IsEnabledAsync("Beta"))
       {
           Console.WriteLine("Welcome to the beta!");
       }
   
       Console.WriteLine("Hello World!");
   }
   

Lokalne kompilowanie i uruchamianie aplikacji

1. Ustaw zmienną środowiskową o nazwie ConnectionString na parametry połączenia magazynu App Configuration.

   Wiersz polecenia systemu Windows

   Jeśli używasz wiersza polecenia systemu Windows, uruchom następujące polecenie.

   setx ConnectionString "<connection-string-of-your-app-configuration-store>"
   

   Uruchom ponownie wiersz polecenia, aby zezwolić na wprowadzenie zmiany. Zweryfikuj poprawność ustawienia, drukując wartość zmiennej środowiskowej.

   Program PowerShell

   Jeśli używasz programu Windows PowerShell, uruchom następujące polecenie.

   $Env:ConnectionString = "<connection-string-of-your-app-configuration-store>"
   

2. Uruchom ponownie program Visual Studio, aby umożliwić zastosowanie zmiany.

3. Naciśnij Ctrl + F5, aby skompilować i uruchomić aplikację.

4. W konsoli powinny zostać wyświetlone następujące dane wyjściowe.

   

5. Zaloguj się w witrynie Azure Portal. Wybierz pozycję Wszystkie zasoby i wybierz utworzony wcześniej magazyn App Configuration.

6. Wybierz pozycję Menedżer funkcji i znajdź flagę funkcji beta . Włącz flagę, zaznaczając pole wyboru w obszarze Włączone.

7. Uruchom ponownie aplikację. W konsoli powinien zostać wyświetlony komunikat beta.

   

Czyszczenie zasobów

Jeśli nie chcesz nadal korzystać z zasobów utworzonych w tym artykule, usuń utworzoną tutaj grupę zasobów, aby uniknąć naliczania opłat.

Ważne

Usunięcie grupy zasobów jest nieodwracalne. Grupa zasobów i wszystkie zasoby w niej są trwale usuwane. Upewnij się, że nie usuniesz przypadkowo nieprawidłowej grupy zasobów ani zasobów. Jeśli zasoby dla tego artykułu zostały utworzone w grupie zasobów zawierającej inne zasoby, które chcesz zachować, usuń każdy zasób oddzielnie z odpowiedniego okienka zamiast usuwać grupę zasobów.

1. Zaloguj się do witryny Azure Portal i wybierz pozycję Grupy zasobów.
2. W polu Filtruj według nazwy wprowadź nazwę grupy zasobów.
3. Na liście wyników wybierz nazwę grupy zasobów, aby wyświetlić przegląd.
4. Wybierz pozycję Usuń grupę zasobów.
5. Zobaczysz prośbę o potwierdzenie usunięcia grupy zasobów. Wprowadź nazwę grupy zasobów, aby potwierdzić, a następnie wybierz pozycję Usuń.

Po kilku chwilach grupa zasobów i wszystkie jej zasoby zostaną usunięte.

Następne kroki

W tym przewodniku Szybki start utworzono flagę funkcji w usłudze App Configuration i użyto jej w aplikacji konsolowej. Aby dowiedzieć się, jak dynamicznie aktualizować flagi funkcji i inne wartości konfiguracji bez ponownego uruchamiania aplikacji, przejdź do następnego samouczka.

Włączanie dynamicznej konfiguracji w aplikacji .NET

Włączanie dynamicznej konfiguracji w aplikacji .NET Framework

Aby włączyć funkcję zarządzania funkcjami dla innych typów aplikacji, przejdź do następujących samouczków.

Używanie flag funkcji w aplikacjach ASP.NET Core

Używanie flag funkcji w usługach w tle platformy .NET

Aby uruchomić pełną funkcję biblioteki zarządzania funkcjami platformy .NET, przejdź do następującego dokumentu.

Zarządzanie funkcjami platformy .NET