クイック スタート:Azure App Configuration を使用して .NET Framework アプリを作成するQuickstart: Create a .NET Framework app with Azure App Configuration

このクイック スタートでは、コードとは別にアプリケーション設定のストレージと管理を一元化するために、Azure App Configuration を .NET Framework ベースのコンソール アプリに組み込みます。In this quickstart, you incorporate Azure App Configuration into a .NET Framework-based console app to centralize storage and management of application settings separate from your code.

前提条件Prerequisites

App Configuration ストアを作成するCreate an App Configuration store

  1. 新しい App Configuration ストアを作成するには、Azure portal にサインインします。To create a new App Configuration store, sign in to the Azure portal. ホーム ページの左上にある [+ リソースの作成] を選択します。In the upper-left corner of the home page, select Create a resource. [Marketplace を検索] ボックスに「App Configuration」と入力し、Enter キーを押します。In the Search the Marketplace box, enter App Configuration and select Enter.

    App Configuration を検索する

  2. 検索結果の [アプリ構成] を選択し、 [作成] を選択します。Select App Configuration from the search results, and then select Create.

    [作成] を選択します

  3. [アプリ構成] > [作成] ウィンドウで、次の設定を入力します。On the App Configuration > Create pane, enter the following settings:

    設定Setting 推奨値Suggested value 説明Description
    リソース名Resource name グローバルに一意の名前Globally unique name App Configuration ストア リソースに使用する一意のリソース名を入力します。Enter a unique resource name to use for the App Configuration store resource. 名前は 5 から 50 文字の文字列で、数字、英字、- 文字のみを使用する必要があります。The name must be a string between 5 and 50 characters and contain only numbers, letters, and the - character. 名前の先頭または末尾を - 文字にすることはできません。The name can't start or end with the - character.
    サブスクリプションSubscription 該当するサブスクリプションYour subscription App Configuration のテストに使用する Azure サブスクリプションを選択します。Select the Azure subscription that you want to use to test App Configuration. アカウントにサブスクリプションが 1 つしかない場合は自動的に選択されるため、 [サブスクリプション] の一覧は表示されません。If your account has only one subscription, it's automatically selected and the Subscription list isn't displayed.
    リソース グループResource group AppConfigTestResourcesAppConfigTestResources App Configuration ストア リソースのリソース グループを選択または作成します。Select or create a resource group for your App Configuration store resource. このグループで複数のリソースをまとめておくと、そのリソース グループを削除することで複数のリソースを同時に削除できるため、便利です。This group is useful for organizing multiple resources that you might want to delete at the same time by deleting the resource group. 詳細については、リソース グループを使用した Azure リソースの管理に関するページを参照してください。For more information, see Use resource groups to manage your Azure resources.
    地域Location 米国中部Central US [場所] を使用して、アプリ構成ストアがホストされている地理的位置を指定します。Use Location to specify the geographic location in which your app configuration store is hosted. 最高のパフォーマンスを得るには、アプリケーションの他のコンポーネントと同じリージョンにリソースを作成します。For the best performance, create the resource in the same region as other components of your application.

    App Configuration ストア リソースを作成する

  4. 作成 を選択します。Select Create. デプロイには数分かかることがあります。The deployment might take a few minutes.

  5. デプロイが完了したら、 [設定] > [アクセス キー] を選択します。After the deployment finishes, select Settings > Access Keys. 接続文字列の読み取り専用の主キーをメモします。Make a note of the primary read-only key connection string. この接続文字列は、後で、作成した App Configuration ストアと通信するようにアプリケーションを構成する際に使用します。You'll use this connection string later to configure your application to communicate with the App Configuration store that you created.

  1. [構成エクスプローラー] > [作成] の順に選択して、次のキーと値のペアを追加します。Select Configuration Explorer > Create to add the following key-value pairs:

    KeyKey Value
    TestApp:Settings:MessageTestApp:Settings:Message Azure App Configuration からのデータData from Azure App Configuration

    [ラベル][コンテンツの種類] は、現時点では空にしておきます。Leave Label and Content Type empty for now.

.NET コンソール アプリを作成するCreate a .NET console app

  1. Visual Studio を起動し、 [ファイル] > [新規] > [プロジェクト] の順に選択します。Start Visual Studio, and select File > New > Project.

  2. [新しいプロジェクトの作成] で、 [コンソール] プロジェクトの種類をフィルターで選択し、 [コンソール アプリ (.NET Framework)] をクリックします。In Create a new project, filter on the Console project type and click on Console App (.NET Framework). [次へ] を選択します。Select Next.

  3. [新しいプロジェクトの構成] で、プロジェクト名を入力します。In Configure your new project, enter a project name. [フレームワーク] で、 .NET Framework 4.7.1 以上を選択します。Under Framework, select .NET Framework 4.7.1 or higher. 作成 を選択します。Select Create.

App Configuration ストアに接続するConnect to an App Configuration store

  1. プロジェクトを右クリックし、 [NuGet パッケージの管理] を選択します。Right-click your project, and select Manage NuGet Packages. [参照] タブで以下の NuGet パッケージを検索し、プロジェクトに追加します。On the Browse tab, search and add the following NuGet packages to your project. 見つからない場合は、 [プレリリースを含める] チェック ボックスをオンにします。If you can't find them, select the Include prerelease check box.

    Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration 1.0.0 preview or later
    Microsoft.Configuration.ConfigurationBuilders.Environment 2.0.0 preview or later
    System.Configuration.ConfigurationManager version 4.6.0 or later
    
  2. プロジェクトの App.config ファイルを次のように更新します。Update the App.config file of your project as follows:

    <configSections>
        <section name="configBuilders" type="System.Configuration.ConfigurationBuildersSection, System.Configuration, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" restartOnExternalChanges="false" requirePermission="false" />
    </configSections>
    
    <configBuilders>
        <builders>
            <add name="MyConfigStore" mode="Greedy" connectionString="${ConnectionString}" type="Microsoft.Configuration.ConfigurationBuilders.AzureAppConfigurationBuilder, Microsoft.Configuration.ConfigurationBuilders.AzureAppConfiguration" />
            <add name="Environment" mode="Greedy" type="Microsoft.Configuration.ConfigurationBuilders.EnvironmentConfigBuilder, Microsoft.Configuration.ConfigurationBuilders.Environment" />
        </builders>
    </configBuilders>
    
    <appSettings configBuilders="Environment,MyConfigStore">
        <add key="AppName" value="Console App Demo" />
        <add key="ConnectionString" value ="Set via an environment variable - for example, dev, test, staging, or production connection string." />
    </appSettings>
    

    App Configuration ストアの接続文字列は環境変数 ConnectionString から読み取られます。The connection string of your App Configuration store is read from the environment variable ConnectionString. appSettings セクションの configBuilders プロパティの MyConfigStore の前に、Environment 構成ビルダーを追加します。Add the Environment configuration builder before the MyConfigStore in the configBuilders property of the appSettings section.

  3. Program.cs を開き、ConfigurationManager を呼び出して App Configuration を使用するように Main メソッドを更新します。Open Program.cs, and update the Main method to use App Configuration by calling ConfigurationManager.

    static void Main(string[] args)
    {
        string message = System.Configuration.ConfigurationManager.AppSettings["TestApp:Settings:Message"];
    
        Console.WriteLine(message);
    }
    

アプリをビルドしてローカルで実行するBuild and run the app locally

  1. ConnectionString という名前の環境変数を App Configuration ストアの接続文字列に設定します。Set an environment variable named ConnectionString to the connection string of your App Configuration store. Windows コマンド プロンプトを使用する場合は、次のコマンドを実行します。If you use the Windows command prompt, run the following command:

        setx ConnectionString "connection-string-of-your-app-configuration-store"
    

    Windows PowerShell を使用する場合は、次のコマンドを実行します。If you use Windows PowerShell, run the following command:

        $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
    
  2. 変更を有効にするために、Visual Studio を再起動します。Restart Visual Studio to allow the change to take effect. Ctrl + F5 キーを押して、アプリをビルドし、実行します。Press Ctrl + F5 to build and run the console app.

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

次のチュートリアルに進む場合は、このクイックスタートで作成したリソースを再利用できるよう残しておいてください。If you plan to continue to the next tutorial, keep the resources you created in this quickstart for that you can reuse them.

クイック スタートのサンプル アプリケーションの使用を終える場合は、課金を避けるために、このクイック スタートで作成した Azure リソースを削除することができます。If you're finished with the quickstart sample application, delete the Azure resources you created in this quickstart to avoid charges.

重要

リソース グループを削除すると、元に戻すことができません。Deleting a resource group is irreversible. リソース グループとそのすべてのリソースは完全に削除されます。The resource group and all the resources in it are permanently deleted. 間違ったリソース グループやリソースをうっかり削除しないようにしてください。Make sure that you don't accidentally delete the wrong resource group or resources. このサンプルをホストするためのリソースを、保持したいリソースを含むリソース グループ内に作成した場合は、リソース グループを削除する代わりに、各リソースをそれぞれのウィンドウから個別に削除します。If you created the resources for hosting this sample inside a resource group that contains resources you want to keep, delete each resource individually from its respective pane instead of deleting the resource group.

  1. Azure portal にサインインし、 [リソース グループ] を選択します。Sign in to the Azure portal, and select Resource groups.
  2. [名前でフィルター] ボックスにリソース グループの名前を入力します。In the Filter by name box, enter the name of your resource group.
  3. 結果一覧からリソース グループを選択し、行を右クリックするか省略記号 ( ... ) ボタンを使用してコンテキスト メニューを開きます。In the result list, select the resource group, and either right-click the row or use the ellipsis (...) button to open the context menu.
  4. [リソース グループの削除] を選択します。Select Delete resource group.
  5. リソース グループの削除の確認を求めるメッセージが表示されます。You're asked to confirm the deletion of the resource group. 確認のためにリソース グループの名前を入力し、 [削除] を選択します。Enter the name of your resource group to confirm, and select Delete.

しばらくすると、リソース グループとそのすべてのリソースが削除されます。After a few moments, the resource group and all its resources are deleted.

次のステップNext steps

このクイックスタートでは、新しい App Configuration ストアを作成して、.NET Framework コンソール アプリと共に使用しました。In this quickstart, you created a new App Configuration store and used it with a .NET Framework console app. アプリケーションの起動後、ConfigurationManager の値 AppSettings は変化しません。The value AppSettings of ConfigurationManager won't change after the application is started. ただし、App Configuration .NET Standard 構成プロバイダー ライブラリは、.NET Framework アプリでも使用できます。The App Configuration .NET Standard configuration provider library, however can also be used in a .NET Framework app. .NET Framework アプリで構成設定を動的に更新できるようにする方法については、次のチュートリアルに進んでください。To learn how to enable your .NET Framework app to dynamically refresh configuration settings, continue to the next tutorial.