通过

使用 Visual Studio 连接服务添加 Azure 存储

  • 项目

使用 Visual Studio，可以使用 Connected Services 功能将以下任一项连接到 Azure 存储：

  • .NET Framework 控制台应用
  • ASP.NET 模型View-Controller （MVC） （.NET Framework）
  • ASP.NET Core
  • .NET Core（包括控制台应用、WPF、Windows 窗体、类库）
  • .NET Core 辅助角色
  • Azure Functions
  • 通用 Windows 平台应用
  • 科尔多瓦

连接的服务功能将所需的所有引用和连接代码添加到项目，并相应地修改配置文件。

先决条件

使用连接服务连接到 Azure 存储

  1. 在 Visual Studio 中打开项目。

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

    显示“添加 Azure 连接服务”屏幕的屏幕截图。

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

    显示“添加服务依赖项”屏幕的屏幕截图。

  4. 在 添加依赖项 页中，选择 Azure 存储。

    显示“添加 Azure 存储”屏幕的屏幕截图。

    如果尚未登录，请登录到 Azure 帐户。 如果没有 Azure 帐户，可以注册 免费试用版。

  5. 在“配置 Azure 存储”屏幕中，选择一个现有的存储帐户，并选择“下一步”。

    如果需要创建存储帐户，请转到下一步。 否则，请跳到步骤 6。

    显示“将现有存储帐户添加到项目”屏幕的屏幕截图。

  6. 若要创建存储帐户，请执行以下操作：

    1. 选择 在对话框底部创建存储帐户。

    2. 填写“Azure 存储: 新建”对话框，并选择“创建”。

      显示“新建 Azure 存储帐户”屏幕的屏幕截图。

    3. 显示 Azure 存储 对话框时，新存储帐户将显示在列表中。 选择列表中的新存储帐户，然后选择 下一步。

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

    显示“指定连接字符串”屏幕的屏幕截图。

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

    显示“更改摘要”屏幕的屏幕截图。

  9. 存储连接服务显示在项目的 连接服务 节点下。

  1. 在 Visual Studio 中打开项目。

  2. 按 Ctrl++Q（或使用主菜单栏右侧的 Visual Studio IDE 中的“搜索”按钮）。

  3. 在“功能搜索”中，输入 ，然后选择“Azure 存储 - 项目”Azure Storage“连接服务”>“添加”>“Azure 存储”>。

    使用功能搜索搜索 Azure 存储的屏幕截图。

  4. 在“连接到依赖项”页中，选择“Azure 存储”，然后选择“下一步”。

    屏幕截图显示连接到依赖项 - Azure 存储。

    如果尚未登录，请登录到 Azure 帐户。 如果没有 Azure 帐户，可以注册 免费试用版。

  5. 在“连接到 Azure 存储”屏幕中，选择一个现有的存储帐户，并选择“下一步”。

    如果需要创建存储帐户，请转到下一步。 否则，请跳到以下步骤。

    显示向项目添加现有存储帐户的屏幕截图。

  6. 若要创建存储帐户，请执行以下操作：

    1. 选择 ，通过绿色加号创建新。

    2. 填写“Azure 存储: 新建”对话框，并选择“创建”。

      新的 Azure 存储帐户。

    3. 显示 Azure 存储 对话框时，新存储帐户将显示在列表中。 选择列表中的新存储帐户，然后选择 下一步。

  7. 输入连接字符串设置名称。 设置名称引用连接字符串设置的名称，因为它显示在 secrets.json 文件或 Azure Key Vault 中。

    显示如何指定连接字符串的屏幕截图。

  8. 选择是要将连接字符串存储在本地机密文件中、Azure Key Vault中，还是不存储在任何位置。

    显示用于存储连接设置的选项的屏幕截图。

    谨慎

    如果使用的是早于 Visual Studio 17.12 的 Visual Studio 版本，并且选择使用 secrets.json 文件，则必须采取安全预防措施，因为可能会公开本地 secrets.json 文件中的连接字符串。 如果使用 Visual Studio 2022 版本 17.12 或更高版本，此过程将生成更安全的结果，因为它会生成连接设置值，而不是使用身份验证凭据的连接字符串。

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

    显示更改摘要的屏幕截图。

  10. 存储连接服务显示在项目的 连接服务 节点下。

了解身份验证

运行前面的过程后，你的应用将设置为使用身份验证来访问存储帐户。 如果选择 secrets.json 方法或 Azure Key Vault，则此身份验证的连接信息将存储在本地。

如果使用 secrets.json 文件，请使用 连接服务 选项卡上 Secrets.json 旁边的三个点打开该文件，然后选择 管理用户机密。 使用 Visual Studio 2022 版本 17.12 及更高版本时，此文件包含的设置通过引用 URI 来获取安全连接字符串，而不是直接获取连接字符串本身。

{
  "StorageConnection:blobServiceUri": "https://webapplication16storagex.blob.core.windows.net/",
  "StorageConnection:queueServiceUri": "https://webapplication16storagex.queue.core.windows.net/",
  "StorageConnection:tableServiceUri": "https://webapplication16storagex.table.core.windows.net/"
}

借助 Visual Studio 17.12 及更高版本中的这些设置，身份验证是自动且灵活的。 从 Visual Studio 本地运行或调试时，Visual Studio 保存的 Azure 凭据用于访问 Azure 存储帐户。 如果从命令行启动应用，首先需要使用 Azure CLI 登录，并且会自动检测和使用这些凭据。 但是，当应用部署到 Azure 并在 Azure 中运行时，它会使用托管标识，而无需更改任何代码。 身份验证支持所有托管环境，因为 Azure 标识 API 会按顺序检查所有链式凭据，并在找到它们时加以使用。 请参阅 DefaultAzureCredential。

后续步骤

Azure 存储支持 Blob 和队列以及其他功能。

若要了解如何使用 blob，可以继续学习 blob 存储快速入门，但可以从 Azure blob 快速入门（.NET）开始，而不是从头开始- 代码示例。

若要了解如何使用队列，请从 Azure 队列存储快速入门（.NET）开始 - 代码示例。

相关内容