Краткое руководство. Добавление флагов функций в приложение .NET Framework

Статья
03/30/2023

В этом кратком руководстве описано, как внедрить Конфигурацию приложений Azure в приложение .NET Framework, чтобы реализовать комплексное управление функциями. Вы можете использовать службу "Конфигурация приложений" для централизованного хранения всех флагов функций и управления их состояниями.

Библиотеки управления функциями .NET расширяют возможности платформы за счет поддержки флагов функций. Эти библиотеки создаются на основе системы конфигурации .NET. Они интегрируются со службой "Конфигурация приложений" посредством поставщика конфигураций .NET.

Предварительные требования

Учетная запись Azure с активной подпиской. Создайте бесплатно.
Хранилище Конфигурация приложений. Создайте магазин.
Visual Studio 2019
.NET Framework 4.8

Добавление флага функции

Добавьте флаг функции с именем Beta в хранилище Конфигурация приложений и оставьте метку и описание со значениями по умолчанию. Дополнительные сведения о добавлении флагов функций в хранилище с помощью портал Azure или CLI см. в статье Создание флага компонента.

Создайте консольное приложение .NET

Запустите Visual Studio и выберите Файл>Создать>Проект.
В разделе Создание проекта с помощью фильтра найдите тип проекта Консоль и щелкните Консольное приложение (.NET Framework) . Щелкните Далее.
В окне Настроить новый проект введите имя проекта. В разделе Платформа выберите .NET Framework 4.8 или более позднюю версию. Нажмите кнопку Создать.

Подключение к хранилищу Конфигурации приложений

Щелкните проект правой кнопкой мыши и выберите Управление пакетами NuGet. На вкладке Обзор найдите и добавьте в проект следующие пакеты NuGet.
```
Microsoft.Extensions.DependencyInjection
Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement
```

Откройте файл Program.cs и добавьте следующие инструкции:

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;
using Microsoft.FeatureManagement;
using System.Threading.Tasks;

Обновите метод Main для подключения к Конфигурации приложения, указав параметр UseFeatureFlags, чтобы получить флаги функции. Затем отобразите сообщение, если флаг функции 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();
    }

Создание и запуск приложения локально

Задайте переменную среды с именем ConnectionString для строки подключения к хранилищу службы "Конфигурация приложений". При использовании командной строки Windows выполните следующую команду:
```
    setx ConnectionString "connection-string-of-your-app-configuration-store"
```
Если вы используете Windows PowerShell, выполните следующую команду:
```
    $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
Перезапустите Visual Studio, чтобы изменение вступило в силу.
Нажмите клавиши CTRL+F5, чтобы скомпилировать и запустить консольное приложение.

Очистка ресурсов

Если вы не планируете в дальнейшем использовать ресурсы, созданные при работе с этой статьей, удалите созданную группу ресурсов, чтобы избежать расходов.

Важно!

Удаление группы ресурсов — процесс необратимый. Группа ресурсов и все содержащиеся в ней ресурсы удаляются без возможности восстановления. Будьте внимательны, чтобы случайно не удалить не те ресурсы или группу ресурсов. Если ресурсы для работы с этой статьей созданы в группе ресурсов, которая содержит другие нужные ресурсы, удалите каждый ресурс отдельно в соответствующей области ресурса, чтобы не удалять группу ресурсов.

Войдите на портал Azure и выберитеГруппы ресурсов.
Введите имя группы ресурсов в поле Фильтровать по имени.
В списке результатов выберите имя группы ресурсов, чтобы просмотреть общие сведения.
Выберите Удалить группу ресурсов.
Подтвердите операцию удаления группы ресурсов. Введите имя группы ресурсов, которую необходимо удалить, и нажмите Удалить.

Через некоторое время группа ресурсов и все ее ресурсы будут удалены.

Дальнейшие действия

В этом кратком руководстве вы создали флаг функции в Конфигурации приложений и использовали его с консольным приложением .NET Framework. Сведения о динамическом обновлении флагов функций и других значениях конфигурации без перезапуска приложения, см. в следующем руководстве.

Включение динамической конфигурации