快速入門：將功能旗標新增至 .NET/.NET Framework 主控台應用程式

發行項
07/12/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 應用程式，請在 [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 訊息。