Rychlý start: Přidání příznaků funkcí do konzolové aplikace .NET/.NET Framework

V tomto rychlém startu začleníte Azure App Configuration do konzolové aplikace .NET nebo .NET Framework, abyste vytvořili kompletní implementaci správy funkcí. Pomocí služby App Configuration můžete centrálně ukládat všechny příznaky funkcí a řídit jejich stavy.

Knihovny pro správu funkcí .NET rozšiřují .NET tím, že poskytují podporu funkčních příznaků. Tyto knihovny jsou postavené na konfiguračním systému .NET. Integrují se se službou App Configuration prostřednictvím svého poskytovatele konfigurace .NET.

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si ho zdarma.
• Úložiště konfigurace aplikace, jak je znázorněno v rychlém startu pro vytvoření konfigurace.
• Visual Studio.
• SDK sada .NET 8.0 nebo novější pro konzolovou aplikaci .NET
• .NET Framework 4.7.2 nebo novější pro konzolovou aplikaci .NET Framework.

Přidání příznaku funkce

Přidejte příznak funkce s názvem Beta do obchodu App Configuration Store a ponechte popis a popis s výchozími hodnotami. Další informace o tom, jak přidat příznaky funkcí do úložiště pomocí webu Azure Portal nebo Azure CLI, najdete v tématu Vytvoření příznaku funkce.

Konfigurace nastavení přístupu

Aplikace, kterou vytvoříte v tomto rychlém průvodci, se připojí ke službě App Configuration Store, aby získala přístup ke konfiguraci vašich funkcí. Pokud se chcete připojit ke službě App Configuration, může vaše aplikace používat ID Microsoft Entra nebo připojovací řetězec. Doporučeným přístupem je MICROSOFT Entra ID.

Microsoft Entra ID (doporučeno)

Přiřazení role konfiguračních dat aplikace

Ve výchozím nastavení se aplikace, kterou vytvoříte, používá DefaultAzureCredential k ověření v obchodě App Configuration Store. DefaultAzureCredential je řetězec přihlašovacích údajů tokenu. Aby autorizace fungovala, musíte udělit roli Čtenář dat konfigurace aplikace přihlašovacím údajům, které vaše aplikace používá. Pokyny najdete v tématu Ověřování pomocí přihlašovacích údajů tokenu. Nechte dostatečný čas, aby se přiřazení role propagovalo před spuštěním aplikace.

Nastav proměnnou prostředí

Vaše aplikace používá proměnnou prostředí k navázání připojení ke službě App Configuration. Pomocí jednoho z následujících příkazů nastavte proměnnou prostředí pojmenovanou Endpoint na koncový bod úložiště App Configuration Store.

• Pokud používáte příkazový řádek, spusťte následující příkaz:

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

  Zavřete a znovu otevřete příkazový řádek, aby se změna projevila. Ověřte, že je proměnná prostředí nastavena, tím že vytisknete její hodnotu do konzole.

• Pokud používáte Windows PowerShell, spusťte následující příkaz:

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

Připojovací řetězec

Vaše aplikace používá proměnnou prostředí k navázání připojení ke službě App Configuration. Pomocí jednoho z následujících příkazů nastavte proměnnou prostředí s názvem ConnectionString na připojovací řetězec vašeho App Configuration Storu.

• Pokud používáte příkazový řádek, spusťte následující příkaz:

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

  Zavřete a znovu otevřete příkazový řádek, aby se změna projevila. Ověřte, že je proměnná prostředí nastavena, tím že vytisknete její hodnotu do konzole.

• Pokud používáte Windows PowerShell, spusťte následující příkaz:

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

Vytvoření konzolové aplikace

Pokud chcete k vytvoření nového projektu konzolové aplikace použít Visual Studio, proveďte následující kroky.

1. Otevřete Visual Studio. Pokud už je spuštěný, zavřete ho a znovu otevřete, aby rozpoznal proměnnou prostředí, kterou jste nastavili v předchozí části.

2. V sadě Visual Studio vyberte Soubor>nový>projekt.

3. V dialogovém okně Vytvořit nový projekt zadejte konzolu do vyhledávacího pole.

   • Pokud chcete vytvořit aplikaci .NET, vyberte Konzolová aplikace a pak vyberte Další.
   • Pokud chcete vytvořit aplikaci .NET Framework, vyberte Konzolová aplikace (.NET Framework) a pak vyberte Další.

4. V dialogovém okně Konfigurovat nový projekt zadejte název projektu.

   • Pokud chcete vytvořit aplikaci .NET, otevřete výběrem možnosti Dalšídialogové okno Další informace . V dialogovém okně vyberte rozhraní .NET Framework, zrušte zaškrtnutí políčka Nepoužívat příkazy nejvyšší úrovně a pak vyberte Vytvořit.
   • Pokud chcete vytvořit aplikaci .NET Framework, v části Framework vyberte rozhraní .NET Framework 4.7.2 nebo novější verzi a pak vyberte Vytvořit.

Použití příznaku funkce

Pokud chcete v aplikaci použít příznak funkce, postupujte následovně.

1. V Průzkumníku řešení klikněte pravým tlačítkem na projekt a pak vyberte Spravovat balíčky NuGet.

2. Na kartě Procházet vyhledejte a přidejte do projektu nejnovější stabilní verze následujících balíčků NuGet:

   Microsoft Entra ID (doporučeno)

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

   Připojovací řetězec

   • Microsoft.Extensions.Configuration.AzureAppConfiguration
   • Microsoft.FeatureManagement

3. Otevřete Program.cs a na začátek souboru přidejte následující příkazy.

   Microsoft Entra ID (doporučeno)

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

   Připojovací řetězec

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

4. Jak je znázorněno v následujících blocích kódu, aktualizujte Program.cs provedením tří změn:

   • Pokud chcete načíst příznaky funkcí z konfigurace aplikace, přidejte volání metody UseFeatureFlags .
   • Pokud chcete číst příznaky funkcí z konfigurace, vytvořte instanci FeatureManager.
   • Zobrazí zprávu, pokud je povolen příznak funkce Beta .
   Microsoft Entra ID (doporučeno)

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

   Připojovací řetězec

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

Sestavení a místní spuštění aplikace

1. V sadě Visual Studio vyberte Ctrl+F5 a sestavte a spusťte aplikaci. V konzole by se měl zobrazit následující výstup.

   

2. Přihlaste se k portálu Azure. Vyberte Všechny prostředky, poté vyberte váš obchod App Configuration Store.

3. Vyberte Správce funkcí a vyhledejte příznak funkce Beta . Zapnutím přepínače Povoleno povolíte příznak.

4. Spusťte aplikaci znovu. Zpráva o beta verzi by se měla zobrazit v konzole.

   

Vyčištění prostředků

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste se vyhnuli poplatkům.

Důležité

Odstranění skupiny prostředků je nevratné. Skupina prostředků a všechny prostředky v ní se trvale odstraní. Ujistěte se, že omylem neodstraníte nesprávnou skupinu prostředků nebo prostředky. Pokud jste vytvořili prostředky pro tento článek ve skupině prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte jednotlivé prostředky z příslušného podokna místo odstranění skupiny prostředků.

1. Přihlaste se k webu Azure Portal a vyberte skupiny prostředků.
2. Do pole Filtrovat podle názvu zadejte název vaší skupiny prostředků.
3. V seznamu výsledků vyberte název skupiny prostředků, abyste zobrazili přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků a vyberte Odstranit.

Po chvíli se skupina prostředků a všechny její prostředky odstraní.

Další kroky

V tomto rychlém startu jste vytvořili příznak funkce v Konfiguraci aplikace a použili ho s konzolovou aplikací. Pokud chcete zjistit, jak dynamicky aktualizovat příznaky funkcí a další konfigurační hodnoty bez restartování aplikace, projděte si následující kurzy:

Použití dynamické konfigurace v aplikaci .NET

Použití dynamické konfigurace v aplikaci .NET Framework

Pokud chcete povolit funkci správy funkcí pro jiné typy aplikací, projděte si následující rychlé starty:

Přidání příznaků funkcí do aplikace ASP.NET Core

Přidejte funkční příznaky do služby na pozadí .NET

Úplný přehled funkcí knihovny pro správu funkcí .NET najdete v následujícím dokumentu:

Správa funkcí .NET