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

v tomto rychlém startu zařadíte do aplikace .NET Framework aplikaci Azure app Configuration a vytvoříte ucelenou implementaci správy funkcí. Službu konfigurace aplikací můžete použít k centrálnímu ukládání všech příznaků funkcí a řízení jejich stavů.

Knihovny pro správu funkcí .NET rozšíří rozhraní s podporou příznaků funkcí. Tyto knihovny jsou postaveny na systému konfigurace .NET. Integrují s konfigurací aplikace prostřednictvím poskytovatele konfigurace .NET.

Požadavky

• Předplatné Azure – Vytvořte si ho zdarma .
• Visual Studio 2019
• .NET Framework 4.8

Vytvoření úložiště konfigurace aplikace

1. Pokud chcete vytvořit nové úložiště konfigurace aplikace, přihlaste se k Azure Portal. V levém horním rohu domovské stránky vyberte vytvořit prostředek. Do pole Hledat na Marketplace zadejte Konfigurace aplikace a vyberte ENTER.

   

2. Ve výsledcích hledání vyberte Konfigurace aplikace a pak vyberte vytvořit.

   

3. V podokně vytvořit konfiguraci aplikace 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í konfigurace aplikace. Pokud má váš účet jenom jedno předplatné, vybere se automaticky a seznam předplatných se nezobrazí.
   Skupina prostředků	AppConfigTestResources	Vyberte nebo vytvořte skupinu prostředků pro prostředek úložiště konfigurace aplikace. Tato skupina je užitečná k organizová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ě konfigurace aplikace. Název musí být řetězec o 5 až 50 znaků a obsahovat pouze čísla, písmena a - znak. Název nesmí začínat ani končit - znakem.
   Umístění	USA – střed	Umístění použijte k určení geografického umístění, ve kterém je úložiště konfigurace aplikace hostované. Nejlepšího výkonu dosáhnete vytvořením prostředku ve stejné oblasti jako jiné součásti aplikace.
   Cenová úroveň	Free	Vyberte požadovanou cenovou úroveň. Další informace najdete na stránce s cenami konfigurace aplikací.

4. Vyberte zkontrolovat + vytvořit a ověřte nastavení.

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

6. Po dokončení nasazení přejděte do prostředku konfigurace aplikace. Vyberte Nastavení > Přístupové klíče. Poznamenejte si primární připojovací řetězec klíče jen pro čtení. Pomocí tohoto připojovacího řetězce později nakonfigurujete aplikaci tak, aby komunikovala s úložištěm konfigurace aplikace, které jste vytvořili.

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

   

   labelPro teď nechte nedefinovaného.

Vytvoření konzolové aplikace .NET

1. spusťte Visual Studio a vyberte soubor > nový > Project.

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

3. V konfiguraci nového projektu zadejte název projektu. v části rozhraní vyberte .NET Framework 4,8 nebo vyšší. Klikněte na Vytvořit.

Připojení do úložiště konfigurace aplikace

1. klikněte pravým tlačítkem na projekt a vyberte spravovat NuGet balíčky. na kartě procházet vyhledejte a přidejte následující balíčky NuGet do svého projektu. Pokud je nemůžete najít, zaškrtněte políčko zahrnout předběžné verze .

   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 Main metodu pro připojení ke konfiguraci aplikace a určete UseFeatureFlags možnost, aby se načetly příznaky funkcí. Pokud Beta je příznak funkce povolený, zobrazí se zpráva.

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

Místní sestavení a spuštění aplikace

1. Nastavte proměnnou prostředí s názvem ConnectionString na připojovací řetězec úložiště konfigurace vaší aplikace. pokud použijete 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. pokud chcete, aby se změna projevila, restartujte Visual Studio.

3. Stisknutím kombinace kláves CTRL + F5 Sestavte a spusťte konzolovou aplikaci.

   

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 předešli poplatkům.

1. Přihlaste se k Azure Portala 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ů, aby se zobrazil přehled.
4. Vyberte Odstranit skupinu prostředků.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Zadejte název vaší skupiny prostředků, který chcete potvrdit, a vyberte Odstranit.

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

Další kroky

v tomto rychlém startu jste v konfiguraci aplikace vytvořili příznak funkce a použili ho v aplikaci .NET Framework konzolové aplikace. Pokud se chcete dozvědět, jak dynamicky aktualizovat příznaky funkcí a jiné hodnoty konfigurace bez restartování aplikace, přejděte k dalšímu kurzu.