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

在本快速入門中，您會將 Azure 應用程式設定併入 .NET 或 .NET Framework 主控台應用程式，以建立功能管理的端對端實作。您可以使用應用程式組態服務來集中儲存所有功能旗標及控制其狀態。

.NET 功能管理程式庫會藉由提供功能旗標支援來擴充 .NET。這些程式庫會建置在 .NET 組態系統之上。透過其 .NET 組態提供者與應用程式組態密切整合。

必要條件

具有有效訂用帳戶的 Azure 帳戶。免費建立一個。
App Configuration 存放區，如建立存放區的快速入門所示。
Visual Studio。
.NET 主控台應用程式的 .NET SDK 8.0 或更新版本。
.NET Framework 4.7.2 或更新版本，適用於 .NET Framework 主控台應用程式。

新增功能旗標

將名為 Beta 的功能旗標新增至應用程式組態存放區，並保留標籤和描述的預設值。如需如何使用 Azure 入口網站或 Azure CLI 將功能旗標新增至存放區的詳細資訊，請參閱建立功能旗標。

設定存取設定

您在本快速入門中建立的應用程式會連線到您的 App Configuration 市集，以存取您的功能旗標設定。若要連線到應用程式設定，您的應用程式可以使用 Microsoft Entra ID 或連接字串。 Microsoft Entra ID 是建議的方法。

Microsoft Entra ID (建議)
連接字串

指派 App Configuration 資料角色

根據預設，您建立的應用程式會用 DefaultAzureCredential 來向 App Configuration 存放區進行驗證。 DefaultAzureCredential 是代幣憑證鏈。若要讓授權正常運作，您必須將 應用程式配置資料讀取者 角色授予應用程式使用的憑證。如需指示，請參閱使用權杖認證進行驗證。在運行您的應用程式之前，請留出足夠的時間讓角色指派生效。

設定環境變數

您的應用程式會使用環境變數來建立與應用程式設定的連線。使用下列其中一個命令來設定名為 Endpoint App Configuration 存放區端點的環境變數。

如果您使用命令提示字元，請執行下列命令：
```
setx Endpoint "<endpoint-of-your-app-configuration-store>"
```
關閉並重新開啟命令提示字元，讓變更生效。將環境變數的值列印到主控台，以確認已設定環境變數。

如果您使用 Windows PowerShell，請執行下列命令：

[System.Environment]::SetEnvironmentVariable("Endpoint", "<endpoint-of-your-app-configuration-store>", "User")

您的應用程式會使用環境變數來建立與應用程式設定的連線。使用下列其中一個命令來設定一個名為ConnectionString的環境變數，其值為你的 App Configuration 存放區的連接字串。

如果您使用命令提示字元，請執行下列命令：
```
setx ConnectionString "<connection-string-of-your-app-configuration-store>"
```
關閉並重新開啟命令提示字元，讓變更生效。將環境變數的值列印到主控台，以確認已設定環境變數。

如果您使用 Windows PowerShell，請執行下列命令：

[System.Environment]::SetEnvironmentVariable("ConnectionString", "<connection-string-of-your-app-configuration-store>", "User")

建立主控台應用程式

若要使用 Visual Studio 建立新的主控台應用程式專案，請採取下列步驟。

開啟 Visual Studio。如果它已經在執行中，請關閉並重新開啟它，以便它辨識您在上一節中設定的環境變數。
在 Visual Studio 中，選取 [檔案>新增>專案]。
在 [建立新專案 ] 對話方塊中，在搜尋方塊中輸入 [主控台 ]。
- 如果您想要建立 .NET 應用程式，請選取 [主控台應用程式]，然後選取 [ 下一步]。
- 如果您想要建立 .NET Framework 應用程式，請選取 [主控台應用程式（.NET Framework）]，然後選取 [ 下一步]。
在 [設定您的新專案 ] 對話方塊中，輸入專案名稱。
- 如果您想要建立 .NET 應用程式，請選取 [ 下一步 ] 以開啟 [其他資訊] 對話方塊。在該對話方塊中，選取 .NET 架構，清除 [ 不使用最上層陳述式 ] 複選框，然後選取 [ 建立]。
- 如果您想要建立 .NET Framework 應用程式，請在 [Framework] 底下選取 [.NET Framework 4.7.2 或更新版本]，然後選取 [建立]。

啟用功能旗標

若要在應用程式中使用功能旗標，請執行下列步驟。

在 [方案總管] 中，以滑鼠右鍵按一下您的專案，然後選取 [管理 NuGet 套件]。
在 [ 瀏覽] 索引標籤上，搜尋下列 NuGet 套件的最新穩定版本，並將其新增至您的專案：
- Microsoft Entra ID (建議)
- 連接字串
- Microsoft.Extensions.Configuration.AzureAppConfiguration
- Microsoft.FeatureManagement
- Azure.身分識別
- Microsoft.Extensions.Configuration.AzureAppConfiguration
- Microsoft.FeatureManagement

開啟 Program.cs 並將下列陳述式新增至檔案的開頭。

Microsoft Entra ID (建議)
連接字串

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

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

如下列程式碼區塊所示，透過進行三項變更來更新 Program.cs ：

若要從應用程式設定載入功能旗標，請新增對 UseFeatureFlags 方法的呼叫。
若要從設定中讀取功能旗標，請建立 FeatureManager 的實例。
如果已啟用 Beta 功能旗標，則會顯示訊息。

Microsoft Entra ID (建議)
連接字串

.NET

IConfiguration configuration = new ConfigurationBuilder()
    .AddAzureAppConfiguration(options =>
    {
        string endpoint = Environment.GetEnvironmentVariable("Endpoint");
        options.Connect(new Uri(endpoint), new DefaultAzureCredential())
               .UseFeatureFlags();
    }).Build();

var featureManager = new FeatureManager(
    new ConfigurationFeatureDefinitionProvider(configuration));

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

Console.WriteLine("Hello World!");

.NET Framework

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

    var featureManager = new FeatureManager(
        new ConfigurationFeatureDefinitionProvider(configuration));

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

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

.NET

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

var featureManager = new FeatureManager(
    new ConfigurationFeatureDefinitionProvider(configuration));

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

Console.WriteLine("Hello World!");

.NET Framework

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

    var featureManager = new FeatureManager(
        new ConfigurationFeatureDefinitionProvider(configuration));

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

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