开始使用 Azure Blob 存储和 .NET

本文介绍如何使用适用于 .NET 的 Azure Blob 存储客户端库连接到 Azure Blob 存储。 连接后,可以针对 Blob 存储服务的容器、Blob 和功能运行代码。

API 参考 | 库源代码 | 包 (NuGet) | 示例

先决条件

设置项目

本部分逐步指导如何准备一个项目,使其与适用于 .NET 的 Azure Blob 存储客户端库配合使用。

从项目目录中,使用 dotnet add package 命令安装 Azure Blob 存储和 Azure 标识客户端库的包。 与 Azure 服务的无密码连接需要 azure-identity 包。

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

将这些 using 语句添加到代码文件的顶部。

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

Blob 客户端库信息:

授予访问权限并连接到 Blob 存储

要将应用连接到 Blob 存储,请创建 BlobServiceClient 类的实例。 此对象是在存储帐户级别与数据资源交互的起点。 可以将其用于对存储账户及其容器执行操作。 还可以使用服务客户端创建容器客户端或 blob 客户端,具体取决于需要使用的资源。

要详细了解如何创建和管理客户端对象,请参阅 创建和管理与数据资源交互的客户端对象

你可以使用 Microsoft Entra 授权令牌、帐户访问密钥或共享访问签名 (SAS) 来为 BlobServiceClient 对象授权。

若要详细了解其中的每种授权机制,请参阅授权访问 Azure 存储中的数据

若要通过 Microsoft Entra ID 授权,需要使用安全主体。 需要的安全主体类型取决于应用程序的运行位置。 使用此表作为指南。

应用程序的运行位置 安全主体 指南
本地计算机(开发和测试) 服务主体 若要了解如何注册应用、设置 Microsoft Entra 组、分配角色和配置环境变量,请参阅使用开发人员服务主体授权访问
本地计算机(开发和测试) 用户标识 若要了解如何设置 Microsoft Entra 组、分配角色和登录到 Azure,请参阅使用开发人员凭据授权访问
在 Azure 中托管 托管标识 若要了解如何启用托管标识和分配角色,请参阅使用托管标识授权从 Azure 托管应用访问
托管在 Azure 外部(例如本地应用) 服务主体 若要了解如何注册应用、分配角色和配置环境变量,请参阅使用应用程序服务主体授权从本地应用访问

使用 DefaultAzureCredential 授权访问

要授予访问权限并连接到 Blob 存储,一种简单且安全的方法是通过创建 DefaultAzureCredential 实例来获取 OAuth 令牌。 然后就可以使用该凭据创建 BlobServiceClient 对象。

以下示例创建了使用 DefaultAzureCredential 授权的 BlobServiceClient 对象:

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.chinacloudapi.cn"),
        new DefaultAzureCredential());

    return client;
}

如果你准确地知道将用于对用户进行身份验证的凭据类型,可以使用适用于 .NET 的 Azure 标识客户端库中的其他类获取 OAuth 令牌。 这些类派生自 TokenCredential 类。

若要详细了解其中的每种授权机制,请参阅授权访问 Azure 存储中的数据

生成应用程序

在生成应用程序以使用 Azure Blob 存储中的数据资源时,代码主要与三种资源类型进行交互:存储帐户、容器和 Blob。 若要详细了解这些资源类型、它们彼此之间的关系以及应用如何与资源交互,请参阅了解应用如何与 Blob 存储数据资源交互

以下指南演示如何使用适用于 .NET 的 Azure 存储客户端库来处理数据资源并执行特定操作:

指南 说明
创建容器 创建容器。
删除和还原容器 删除容器;如果启用了软删除,则还原已删除的容器。
列出容器 列出帐户中的容器以及可用于自定义列表的各个选项。
管理属性和元数据 获取和设置容器的属性与元数据。
创建和管理容器租用 在容器上建立和管理锁。
创建和管理 Blob 租用 在 Blob 上建立和管理锁。
将数据追加到 Blob 了解如何创建追加 Blob,然后将数据追加到该 Blob。
上传 Blob 了解如何使用字符串、流、文件路径和其他方法上传 Blob。
下载 blob 使用字符串、流和文件路径下载 Blob。
复制 blob 将 Blob 从一个位置移复制到另一个位置。
列出 Blob 以不同的方式列出 Blob。
删除和还原 删除 Blob;如果启用了软删除,则还原已删除的 Blob。
使用标记查找 Blob 设置和检索标记,以及使用标记来查找 Blob。
管理属性和元数据 获取和设置 Blob 的属性与元数据。
设置或更改 blob 的访问层 设置或更改块 blob 的访问层。

请参阅