使用 Visual Studio 连接服务添加 Azure 应用程序配置

在本教程中,你将了解如何轻松添加开始使用 Azure 应用程序配置来管理 Visual Studio 中 Web 项目的配置和功能标志所需的所有内容。 通过在 Visual Studio 中使用连接服务功能,你可以让 Visual Studio 自动添加连接到 Azure 中的应用程序配置资源所需的所有代码、NuGet 包和配置设置。 若要使用此功能,必须使用 Visual Studio 2019 版本 16.9 或更高版本。

可以在以下项目类型中使用应用程序配置连接服务功能:

  • ASP.NET Core
  • .NET Core 控制台
  • .NET Framework 项目。

注意

本主题适用于 Visual Studio Windows 版。 有关 Visual Studio for Mac,请参阅 Visual Studio for Mac 中连接服务

先决条件

使用连接服务连接到 Azure 应用程序配置

  1. 在 Visual Studio 中打开项目。

  2. 在“解决方案资源管理器”中,右键单击“连接服务”节点,并在上下文菜单中选择“添加连接服务”。

    Screenshot showing

  3. 在“连接服务”选项卡中,选择“服务依赖项”的 + 图标。

    Screenshot showing

  4. 在“添加依赖关系”页中,选择“Azure 应用程序配置”。

    Screenshot showing

    如果你还没有登录,请登录到 Azure 帐户。 如果没有 Azure 帐户,可以注册免费试用版

  5. 在“配置 Azure 应用程序配置”屏幕中,选择订阅和现有配置存储区。 然后,选择“下一步”。

    如果需要创建应用程序配置存储区,请转到下一步。 否则,请跳到步骤 6。

    Screenshot showing

  6. 若要创建应用程序配置存储区,请执行以下操作:

    1. 选择“应用程序配置存储区”标题右侧的 + 图标。

    2. 填写“Azure 应用程序配置: 新建”对话框,并选择“创建”。 请注意,“资源名称”字段必须是唯一的。

      Screenshot showing New Azure app config store.

    3. 当显示“Azure 应用程序配置”对话框时,新的配置存储区会显示在列表中。 选择这个新的存储区,然后选择“下一步”。

  7. 输入连接字符串名称,然后选择是要将连接字符串存储在本地机密文件中还是存储在 Azure Key Vault 中。

    Screenshot showing

  8. “更改摘要”屏幕显示了在完成该过程后将对项目进行的所有修改。 如果更改看起来正常,请选择“完成”。

    Screenshot showing summary of changes.

  9. 完成“依赖关系配置过程”后,Azure 应用程序配置现在会显示在项目的“服务依赖关系”节点下。

  1. 在 Visual Studio 中打开项目。

  2. 在“解决方案资源管理器”中,右键单击“连接的服务”节点,并在上下文菜单中选择“添加”,打开可用服务的菜单。

    Screenshot showing Connected Services context menu options.

  3. 选择“Azure 应用程序配置”。 随即显示“连接到依赖项”页。

    Screenshot showing Connect to dependency for Azure App Configuration.

    如果你还没有登录,请登录到 Azure 帐户。 如果没有 Azure 帐户,可以注册免费试用版

  4. 在“配置 Azure 应用程序配置”屏幕中,选择订阅和现有配置存储区。 然后,选择“下一步”。

    如果需要创建应用程序配置存储区,请转到下一步。 否则,请跳到步骤 6。

    Screenshot showing 'Add existing configuration account to project

  5. 若要创建应用程序配置存储区,请执行以下操作:

    1. 选择“应用程序配置存储区”标题右侧的 + 图标。

    2. 填写“Azure 应用程序配置: 新建”对话框,并选择“创建”。 请注意,“资源名称”字段必须是唯一的。

      Screenshot showing new Azure app config store.

    3. 当显示“Azure 应用程序配置”对话框时,新的配置存储区会显示在列表中。 选择这个新的存储区,然后选择“下一步”。

  6. 输入连接字符串名称,然后选择是要将连接字符串存储在本地机密文件中还是存储在 Azure Key Vault 中。

    Screenshot showing

  7. “更改摘要”屏幕显示了在完成该过程后将对项目进行的所有修改。 如果更改看起来正常,请选择“完成”。

    Screenshot showing summary of changes.

    完成“依赖关系配置过程”后,Azure 应用程序配置现在会显示在项目的“服务依赖关系”节点下。

  8. 在“解决方案资源管理器”中,双击“连接的服务”节点以打开“连接的服务”选项卡。连接显示在“服务依赖项”部分下:

    Screenshot of Service Dependencies section showing Azure App Configuration connection.

    还有一个 Secrets.json 条目,用于支持本地连接字符串的安全存储。 参阅显示 ASP.NET Core 中所开发应用机密的安全存储的屏幕截图,了解其工作原理。

    如果单击添加的依赖项旁边的三个点,可以看到各种选项(例如“连接”)以重新打开向导并更改连接,若是 Secrets.json,使用选项可管理机密。 还可以单击窗口右上角的三个点,查看用于启动本地依赖项、更改设置等的选项。