你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

项目
04/08/2024

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

先决条件

具有活动订阅的 Azure 帐户。免费创建一个。
应用程序配置存储区。创建存储区。
.NET SDK 6.0 或更高版本 - 也可在 Azure Cloud Shell 中使用。

添加键值

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

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

创建 .NET 控制台应用

可以使用 .NET 命令行接口 (CLI) 创建新的 .NET 控制台应用项目。通过 Visual Studio 使用 .NET CLI 的优点是，它可用于 Windows、macOS 和 Linux 平台。或者，使用 Azure Cloud Shell 中提供的预安装工具。

为项目新建一个文件夹。
在新文件夹中，运行以下命令以创建新的 .NET 控制台应用项目：
```
dotnet new console
```

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

通过运行以下命令，添加对 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 方法以使用应用配置。

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

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

在本地生成并运行应用

设置名为“ConnectionString”的环境变量，并将其设置为应用程序配置存储区的访问密钥。在命令行中运行以下命令：
若要使用 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 门户，然后选择“资源组”。
在“按名称筛选”框中，输入资源组的名称。
在结果列表中，选择资源组名称以查看概述。
选择“删除资源组”。
系统会要求确认是否删除资源组。重新键入资源组的名称进行确认，然后选择“删除” 。

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

后续步骤

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

启用动态配置

通过