クイックスタート: App Configuration を使用して .NET アプリを作成する

[アーティクル]
02/21/2024

このクイックスタートでは、コードとは別にアプリケーション設定のストレージと管理を一元化するために、Azure App Configuration を .NET コンソールアプリに組み込みます。

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。無料で作成できます。
App Configuration ストア。ストアを作成する。
.NET SDK 6.0 以降 - Azure Cloud Shell でも利用できます。

キーと値を追加する

App Configuration ストアに次のキーと値を追加し、[ラベル] と [コンテンツのタイプ] を既定値のままにします。 Azure portal または CLI を使用してストアにキーと値を追加する方法の詳細については、キーと値の作成に関する記事を参照してください。

キー	値
TestApp:Settings:Message	Azure App Configuration からのデータ

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

.NET コマンドラインインターフェイス (CLI) を使用し、新しい .NET コンソールアプリプロジェクトを作成できます。 Visual Studio ではなく .NET CLI を使用する利点は、Windows、macOS、および Linux プラットフォームで使用できることです。代わりに、Azure Cloud Shell で提供されているプレインストールのツールを使用します。

プロジェクト用の新規フォルダーを作成します。
新しいフォルダーで次のコマンドを実行して、新しい .NET コンソールアプリプロジェクトを作成します。
```
dotnet new console
```

App Configuration ストアに接続する

次のコマンドを実行して、Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet パッケージへの参照を追加します。
```
dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
```
次のコマンドを実行して、プロジェクトのパッケージを復元します。
```
dotnet restore
```

Program.cs を開き、次のステートメントを追加します。

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

Program.cs ファイルで AddAzureAppConfiguration メソッドを呼び出して App Configuration を使用します。

var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));

var config = builder.Build();
Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");

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

ConnectionString という名前の環境変数に、App Configuration ストアへのアクセスキーを設定します。コマンドラインで次のコマンドを実行します。
Windows コマンドプロンプトを使用してアプリをローカルでビルドして実行するには、次のコマンドを実行します。
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
変更を有効にするために、コマンドプロンプトを再起動します。環境変数の値を出力して、正しく設定されていることを確認します。
Windows PowerShell を使用する場合は、次のコマンドを実行します。
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
MacOS を使用する場合は、次のコマンドを実行します。
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
Linux を使用する場合は、次のコマンドを実行します。
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
次のコマンドを実行して、コンソールアプリをビルドします。
```
dotnet build
```
ビルドが正常に完了したら、次のコマンドを実行して、アプリをローカルで実行します。
```
dotnet run
```

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

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

重要

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

Azure portal にサインインし、 [リソースグループ] を選択します。
[名前でフィルター] ボックスにリソースグループの名前を入力します。
結果一覧でリソースグループ名を選択し、概要を表示します。
[リソースグループの削除] を選択します。
リソースグループの削除の確認を求めるメッセージが表示されます。確認のためにリソースグループの名前を入力し、 [削除] を選択します。

しばらくすると、リソースグループとそのすべてのリソースが削除されます。

次のステップ

このクイックスタートでは、新しい App Configuration ストアを作成して、App Configuration プロバイダーから .NET コンソールアプリと共に使用しました。構成設定を動的に更新するように .NET アプリを構成する方法については、次のチュートリアルに進んでください。

動的な構成を有効にする

クイック スタート: App Configuration を使用して .NET アプリを作成する