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

项目
11/11/2024

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

先决条件

具有活动订阅的 Azure 帐户。创建试用版订阅。
应用程序配置存储区。创建存储区。
.NET Core SDK。

添加键值

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

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

创建 .NET 控制台应用

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

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

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

可以使用 Microsoft Entra ID（建议）或连接字符串连接到应用程序配置存储区。

通过运行以下命令添加 NuGet 包引用：

Microsoft Entra ID（推荐）
连接字符串

dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
dotnet add package Azure.Identity

dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration

运行以下命令，还原项目包：
```
dotnet restore
```

打开 Program.cs 文件，并添加以下命名空间：

Microsoft Entra ID（推荐）
连接字符串

using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.Configuration.AzureAppConfiguration;
using Azure.Identity;

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

通过调用 Program.cs 文件中的 AddAzureAppConfiguration 方法连接到应用程序配置存储区。

Microsoft Entra ID（推荐）
连接字符串

可以使用 DefaultAzureCredential 向应用程序配置存储区进行身份验证。按照说明为凭据分配应用程序配置数据读取者角色。在运行应用程序之前，请务必留出足够的时间来传播权限。

var builder = new ConfigurationBuilder();
builder.AddAzureAppConfiguration(options =>
{
    string endpoint = Environment.GetEnvironmentVariable("Endpoint");
    options.Connect(new Uri(endpoint), new DefaultAzureCredential());
});

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

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

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

在本地生成并运行应用

设置环境变量。
- Microsoft Entra ID（推荐）
- 连接字符串
将名为 Endpoint 的环境变量设置为 Azure 门户中存储的概述下的应用程序配置存储区的终结点。

如果使用 Windows 命令提示符，则请运行以下命令并重启命令提示符，这样更改才会生效：
```
setx Endpoint "endpoint-of-your-app-configuration-store"
```
如果使用 PowerShell，请运行以下命令：
```
$Env:Endpoint = "endpoint-of-your-app-configuration-store"
```
如果使用 macOS 或 Linux，则请运行以下命令：
```
export Endpoint='endpoint-of-your-app-configuration-store'
```
将名为 ConnectionString 的环境变量设置为 Azure 门户中存储的访问密钥下的应用程序配置存储区的只读连接字符串。

如果使用 Windows 命令提示符，则请运行以下命令并重启命令提示符，这样更改才会生效：
```
setx ConnectionString "connection-string-of-your-app-configuration-store"
```
如果使用 PowerShell，请运行以下命令：
```
$Env:ConnectionString = "connection-string-of-your-app-configuration-store"
```
如果使用 macOS 或 Linux，则请运行以下命令：
```
export ConnectionString='connection-string-of-your-app-configuration-store'
```
运行以下命令以生成控制台应用：
```
dotnet build
```
生成成功完成后，请运行以下命令以在本地运行应用：
```
dotnet run
```

清理资源

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

重要

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

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

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

后续步骤

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

启用动态配置