你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：向 .NET Framework 应用添加功能标志

项目
04/03/2023

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

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

先决条件

具有活动订阅的 Azure 帐户。免费创建一个。
应用程序配置存储区。创建存储区。
Visual Studio 2019
.NET Framework 4.8

添加功能标志

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

创建 .NET 控制台应用

启动 Visual Studio，并选择“文件”>“新建”>“项目” 。
在创建新项目中，针对“控制台” 项目类型进行筛选，然后单击“控制台应用(.NET Framework)” 。单击“下一步”。
在配置新项目中，输入项目名称。在“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 控制台应用。若要了解如何在不重启应用程序的情况下动态更新功能标志和其他配置值，请继续学习下一教程。

启用动态配置