快速入门：将功能标志添加到 .NET/.NET Framework 控制台应用

项目
08/03/2024

在本快速入门中，你要将 Azure 应用程序配置合并到 .NET 控制台应用中，以创建功能管理的端到端实现。可以使用应用配置集中存储所有功能标志并控制其状态。

.NET 功能管理库使用功能标志支持扩展该框架。这些库在 .NET 配置系统的基础上构建。它们通过其 .NET 配置提供程序与应用程序配置集成。

先决条件

具有活动订阅的 Azure 帐户。创建试用版订阅。
应用程序配置存储区。创建存储区。
Visual Studio
适用于 .NET 控制台应用的 .NET SDK 6.0 或更高版本。
适用于 .NET Framework 控制台应用的 .NET Framework 4.7.2 或更高版本。

添加功能标志

将名为“Beta”的功能标志添加到应用程序配置存储区，并将“标签”和“描述”保留为其默认值。有关如何使用 Azure 门户或 CLI 将功能标志添加到存储区的详细信息，请转到创建功能标志。

创建控制台应用

可以使用 Visual Studio 创建新的控制台应用项目。

启动 Visual Studio，并选择“文件”>“新建”>“项目” 。
在“创建新项目”中，筛选“控制台”项目类型并选择“控制台应用”。如果你要创建 .NET Framework 应用，请改为选择“控制台应用(.NET Framework)”。单击 “下一步” 。
在配置新项目中，输入项目名称。如果你要创建 .NET Framework 应用，请在“框架”下选择“.NET Framework 4.7.2”或更高版本。单击 “创建” 。

使用功能标志

右键单击项目，然后选择“管理 NuGet 包” 。在“浏览”选项卡中，搜索以下 NuGet 包并将其添加到项目中。
```
Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement
```
确保 Microsoft.FeatureManagement 的版本大于 3.1.0。

打开文件 Program.cs 并添加以下语句。

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

连接到应用程序配置，指定 UseFeatureFlags 选项以检索功能标志。创建一个 ConfigurationFeatureDefinitionProvider，以从配置提供功能标志定义，以及用于评估功能标志状态的 FeatureManager。若启用 Beta 功能标志，将显示一条消息。

.NET
.NET Framework

IConfiguration configuration = new ConfigurationBuilder()
    .AddAzureAppConfiguration(options =>
    {
        options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
            .UseFeatureFlags();
    }).Build();

IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);

IFeatureManager featureManager = new FeatureManager(
    featureDefinitionProvider, 
    new FeatureManagementOptions());

if (await featureManager.IsEnabledAsync("Beta"))
{
    Console.WriteLine("Welcome to the beta!");
}

Console.WriteLine("Hello World!");

public static async Task Main(string[] args)
{         
    IConfiguration configuration = new ConfigurationBuilder()
        .AddAzureAppConfiguration(options =>
        {
            options.Connect(Environment.GetEnvironmentVariable("ConnectionString"))
                .UseFeatureFlags();
        }).Build();

    IFeatureDefinitionProvider featureDefinitionProvider = new ConfigurationFeatureDefinitionProvider(configuration);

    IFeatureManager featureManager = new FeatureManager(
        featureDefinitionProvider, 
        new FeatureManagementOptions());

    if (await featureManager.IsEnabledAsync("Beta"))
    {
        Console.WriteLine("Welcome to the beta!");
    }

    Console.WriteLine("Hello World!");
}

在本地生成并运行应用

将名为 ConnectionString 的环境变量设置为应用程序配置存储区的连接字符串。
- Windows 命令提示符
- PowerShell
如果使用 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 门户。选择“所有资源”，然后选择先前创建的应用程序配置存储。
选择“功能管理器”并找到“Beta”功能标志。通过选中“已启用”下的复选框来启用该标志。
再次运行应用程序。控制台中应会显示 Beta 消息。