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

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

先决条件

• Azure 订阅 - 创建免费帐户
• 应用程序配置存储区。 创建存储区。
• .NET Core SDK。

添加键值

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

创建 .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 并添加以下语句：

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

4. 通过调用 Program.cs 文件中的 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 命令提示符
   • PowerShell
   • macOS
   • Linux

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

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

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

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

   dotnet build
   

3. 生成成功完成后，请运行以下命令以在本地运行应用：

   dotnet run
   

清理资源

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

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

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

后续步骤

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