クイックスタート: .NET/.NET Framework コンソールアプリに機能フラグを追加する

2025-02-25

このクイックスタートでは、Azure App Configuration を .NET コンソールアプリに組み込み、機能管理のエンドツーエンド実装を作成します。 App Configuration を使用し、すべての機能フラグを一箇所に格納し、その状態を制御できます。

.NET 機能管理ライブラリは、機能フラグのサポートにより、フレームワークを拡張します。これらのライブラリは、.NET 構成システム上に構築されます。 .NET 構成プロバイダーを介して、App Configuration と統合されます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料で作成できます。
App Configuration ストア。ストアを作成する。
Visual Studio
.NET コンソールアプリには .NET SDK 6.0 以降。
.NET Framework コンソールアプリには .NET Framework 4.7.2 以降。

機能フラグを追加する

Beta という機能フラグを App Configuration ストアに追加し、[ラベル] と [説明] を既定値のままにします。 Azure portal または CLI を使用してストアに機能フラグを追加する方法の詳細については、「機能フラグを作成する」を参照してください。

コンソールアプリを作成する

Visual Studio を使用し、新しいコンソールアプリプロジェクトを作成できます。

Visual Studio を起動し、 [ファイル]>[新規]>[プロジェクト] の順に選択します。
[新しいプロジェクトの作成] で、[コンソール] プロジェクトの種類をフィルターで選択し、[コンソールアプリ] を選択します。 .NET Framework アプリを作成する場合、代わりにコンソールアプリ (.NET Framework) を選択します。次へをクリックします。
[新しいプロジェクトの構成] で、プロジェクト名を入力します。 .NET Framework アプリを作成する場合、[フレームワーク] で .NET Framework 4.7.2 以降を選択します。 Create をクリックしてください。

機能フラグを使用する

プロジェクトを右クリックし、 [NuGet パッケージの管理] を選択します。 [参照] タブで、次の NuGet パッケージの最新の安定バージョンを検索し、プロジェクトに追加します。
- Microsoft Entra ID (推奨)
- 接続文字列
```
Microsoft.Extensions.Configuration.AzureAppConfiguration
Microsoft.FeatureManagement
Azure.Identity
```
```
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 ファイルを更新し、App Configuration から機能フラグを読み込む UseFeatureFlags メソッドの呼び出しを追加します。次に、FeatureManager を作成して、構成から機能フラグを読み取ります。最後に、Beta 機能フラグが有効になっている場合は、メッセージを表示します。

Microsoft Entra ID (推奨) または接続文字列を使用して App Configuration ストアに接続できます。

Microsoft Entra ID (推奨)
接続文字列

DefaultAzureCredential を使って、既定で App Configuration ストアに対する認証を行います。手順に従って、資格情報に App Configuration データ閲覧者ロールを割り当てます。アプリケーションを実行する前に、アクセス許可が伝わるのに十分な時間をおいてください。

.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!");
}

アプリをビルドしてローカルで実行する

ConnectionString という名前の環境変数を App Configuration ストアの接続文字列に設定します。
- 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 portal にサインインします。 [すべてのリソース] を選択し、自分が前に作成した App Configuration ストアを選択します。
[機能マネージャー] を選択し、[Beta] 機能フラグを見つけます。 [有効] のチェックボックスをオンにして、フラグを有効にします。
アプリケーションをもう一度実行するコンソールにベータ版のメッセージが表示されます。

リソースをクリーンアップする

この記事で作成したリソースを継続して使用しない場合は、ここで作成したリソースグループを削除して課金されないようにしてください。

重要

リソースグループを削除すると、元に戻すことができません。リソースグループとそのすべてのリソースは完全に削除されます。間違ったリソースグループやリソースをうっかり削除しないようにしてください。この記事のリソースを、保持したい他のリソースを含むリソースグループ内に作成した場合は、リソースグループを削除する代わりに、各リソースをそれぞれのペインから個別に削除します。