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

V tomto rychlém startu zahrnete Azure App Configuration do aplikace .NET Framework a vytvoříte 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í architekturu s podporou příznaků funkcí. Tyto knihovny jsou založené na konfiguračním systému .NET. Integrují se s App Configuration prostřednictvím svého poskytovatele konfigurace .NET.

Požadavky

Vytvoření úložiště App Configuration

  1. Pokud chcete vytvořit nové úložiště App Configuration, přihlaste se k Azure Portal.

  2. V levém horním rohu domovské stránky vyberte Vytvořit prostředek.

  3. Do vyhledávacích služeb a marketplace zadejte App Configuration a vyberte Enter.

    Snímek obrazovky znázorňující stránku Hledat App Configuration

  4. Ve výsledcích hledání vyberte App Configuration a pak vyberte Vytvořit.

    Snímek obrazovky znázorňující stránku Vytvořit

  5. V podokně Vytvořit App Configuration zadejte následující nastavení:

    Nastavení Navrhovaná hodnota Popis
    Předplatné Vaše předplatné Vyberte předplatné Azure, které chcete použít k testování App Configuration. Pokud má váš účet jenom jedno předplatné, vybere se automaticky a nezobrazí se seznam předplatných .
    Skupina prostředků AppConfigTestResources Vyberte nebo vytvořte skupinu prostředků pro prostředek App Configuration store. Tato skupina je užitečná pro uspořádání více prostředků, které můžete chtít odstranit současně odstraněním skupiny prostředků. Další informace najdete v tématu Použití skupin prostředků ke správě prostředků Azure.
    Název prostředku Globálně jedinečný název Zadejte jedinečný název prostředku, který se má použít pro prostředek úložiště App Configuration. Název musí být řetězec mezi 5 a 50 znaky a musí obsahovat jenom čísla, písmena a - znak. Název nemůže začínat ani končit znakem - .
    Umístění USA – střed Pomocí umístění určete zeměpisné umístění, ve kterém je hostované vaše úložiště konfigurace aplikací. Pokud chcete dosáhnout nejlepšího výkonu, vytvořte prostředek ve stejné oblasti jako ostatní komponenty aplikace.
    Cenová úroveň Free Vyberte požadovanou cenovou úroveň. Další informace najdete na stránce s cenami App Configuration.
  6. Vyberte Zkontrolovat a vytvořit a ověřte nastavení.

  7. Vyberte Vytvořit. Nasazení může trvat několik minut.

  8. Po dokončení nasazení přejděte na App Configuration prostředek. Vyberte Nastavení>Přístupové klíče. Poznamenejte si připojovací řetězec primárního klíče jen pro čtení. Tento připojovací řetězec použijete později ke konfiguraci aplikace pro komunikaci s App Configuration úložištěm, které jste vytvořili.

  1. Vyberte Správce> funkcí+ Přidat a přidejte příznak funkce s názvem Beta.

    Povolení příznaku funkce s názvem Beta

    Prozatím nechte label nedefinované.

Vytvoření konzolové aplikace .NET

  1. Spusťte Visual Studio a vyberte Soubor>nový>projekt.

  2. V části Vytvořit nový projekt vyfiltrujte typ projektu konzoly a klikněte na konzolovou aplikaci (.NET Framework). Klikněte na Next (Další).

  3. Do konfigurace nového projektu zadejte název projektu. V části Framework vyberte rozhraní .NET Framework 4.8 nebo vyšší. Klikněte na Vytvořit.

Připojení k úložišti App Configuration

  1. Klikněte pravým tlačítkem na projekt a vyberte Spravovat balíčky NuGet. Na kartě Procházet vyhledejte a přidejte do projektu následující balíčky NuGet.

    Microsoft.Extensions.DependencyInjection
    Microsoft.Extensions.Configuration.AzureAppConfiguration
    Microsoft.FeatureManagement
    
  2. Otevřete Program.cs a přidejte následující příkazy:

    using Microsoft.Extensions.DependencyInjection;
    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    using Microsoft.FeatureManagement;
    using System.Threading.Tasks;
    
  3. Aktualizujte metodu Main pro připojení k App Configuration a určete UseFeatureFlags možnost tak, aby se načetly příznaky funkcí. Pokud je příznak funkce povolený, zobrazí se zpráva Beta .

        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();
        }
    

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

  1. Nastavte proměnnou prostředí s názvem ConnectionString na připojovací řetězec vašeho App Configuration úložiště. Pokud používáte příkazový řádek windows, spusťte následující příkaz:

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

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

        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    
  2. Restartujte Visual Studio, aby se změna projevila.

  3. Stisknutím kombinace kláves Ctrl + F5 sestavíte a spustíte konzolovou aplikaci.

    Aplikace s povoleným příznakem funkce

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 zde 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 uvnitř skupiny prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte každý prostředek jednotlivě z příslušného podokna místo odstranění skupiny prostředků.

  1. Přihlaste se k Azure Portal a vyberte skupiny prostředků.
  2. Do pole Filtrovat podle názvu zadejte název skupiny prostředků.
  3. V seznamu výsledků vyberte název skupiny prostředků, abyste viděli přehled.
  4. Vyberte Odstranit skupinu prostředků.
  5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název skupiny prostředků, který chcete potvrdit, 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 App Configuration a použili ho s konzolovou aplikací .NET Framework. Pokud chcete zjistit, jak dynamicky aktualizovat příznaky funkcí a další konfigurační hodnoty bez restartování aplikace, pokračujte dalším kurzem.