快速入门:使用应用程序配置创建 .NET 应用

在本快速入门中,会将 Azure 应用程序配置合并到 .NET 控制台应用中,以集中存储和管理与代码分离的应用程序设置。

先决条件

添加键值

将以下键值添加到应用程序配置存储区,并让“标签”和“内容类型”保留默认值。 有关如何使用 Azure 门户或 CLI 将键值添加到存储区的详细信息,请转到创建键值

密钥
TestApp:Settings:Message Azure 应用配置的数据

创建 .NET 控制台应用

使用 .NET 命令行接口 (CLI) 创建新的 .NET 控制台应用项目。 通过 Visual Studio 使用 .NET CLI 的优点是,它可用于 Windows、macOS 和 Linux 平台。

  1. 为项目新建一个文件夹。

  2. 在新文件夹中,运行以下命令以创建新的 .NET 控制台应用项目:

    dotnet new console
    

连接到应用程序配置存储区

  1. 通过运行以下命令,添加对 Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet 包的引用:

    dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
    
  2. 运行以下命令,还原项目包:

    dotnet restore
    
  3. 打开 Program.cs,并添加对 .NET 应用程序配置提供程序的引用。

    using Microsoft.Extensions.Configuration;
    using Microsoft.Extensions.Configuration.AzureAppConfiguration;
    
  4. 通过调用 Program.cs 文件中的 builder.AddAzureAppConfiguration() 方法以使用应用配置。

    var builder = new ConfigurationBuilder();
    builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
    
    var config = builder.Build();
    Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
    

在本地生成并运行应用

  1. 设置名为“ConnectionString”的环境变量,并将其设置为应用程序配置存储区的访问密钥 。 在命令行中运行以下命令:

    若要使用 Windows 命令提示符在本地生成和运行应用,请运行以下命令:

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

    重启命令提示符以使更改生效。 输出环境变量的值以验证其设置是否正确。

  2. 运行以下命令以生成控制台应用:

    dotnet build
    
  3. 生成成功完成后,请运行以下命令以在本地运行应用:

    dotnet run
    

清理资源

如果不想继续使用本文中创建的资源,请删除此处创建的资源组以避免产生费用。

重要

删除资源组的操作不可逆。 将永久删除资源组以及其中的所有资源。 请确保不要意外删除错误的资源组或资源。 如果在包含要保留的其他资源的资源组中创建了本文的资源,请从相应的窗格中单独删除每个资源,而不是删除该资源组。

  1. 登录到 Azure 门户,然后选择“资源组”。
  2. 在“按名称筛选”框中,输入资源组的名称
  3. 在结果列表中,选择资源组名称以查看概述。
  4. 选择“删除资源组”。
  5. 系统会要求确认是否删除资源组。 重新键入资源组的名称进行确认,然后选择“删除” 。

片刻之后,将会删除该资源组及其所有资源。

后续步骤

本快速入门介绍了如何创建新的应用程序配置存储区,以及如何通过应用程序配置提供程序将其与 .NET 控制台应用配合使用。 若要了解如何配置 .NET 应用来动态刷新配置设置,请继续学习下一个教程。