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

BlobContainerClient.GetBlobsByHierarchyAsync 方法

定义

命名空间:

Azure.Storage.Blobs

程序集:

Azure.Storage.Blobs.dll

包:

Azure.Storage.Blobs v12.20.0

Source:

BlobContainerClient.cs

该 GetBlobsByHierarchyAsync(BlobTraits, BlobStates, String, String, CancellationToken) 操作将返回此容器中的 Blob 的异步集合。 枚举 Blob 可能会向服务发出多个请求，同时提取所有值。 Blob 按字典顺序按名称排序。 delimiter可以使用 来遍历 Blob 的虚拟层次结构，就像它是一个文件系统一样。

有关详细信息，请参阅 列出 Blob。

public virtual Azure.AsyncPageable<Azure.Storage.Blobs.Models.BlobHierarchyItem> GetBlobsByHierarchyAsync (Azure.Storage.Blobs.Models.BlobTraits traits = Azure.Storage.Blobs.Models.BlobTraits.None, Azure.Storage.Blobs.Models.BlobStates states = Azure.Storage.Blobs.Models.BlobStates.None, string delimiter = default, string prefix = default, System.Threading.CancellationToken cancellationToken = default);

abstract member GetBlobsByHierarchyAsync : Azure.Storage.Blobs.Models.BlobTraits * Azure.Storage.Blobs.Models.BlobStates * string * string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Storage.Blobs.Models.BlobHierarchyItem>
override this.GetBlobsByHierarchyAsync : Azure.Storage.Blobs.Models.BlobTraits * Azure.Storage.Blobs.Models.BlobStates * string * string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Storage.Blobs.Models.BlobHierarchyItem>

Public Overridable Function GetBlobsByHierarchyAsync (Optional traits As BlobTraits = Azure.Storage.Blobs.Models.BlobTraits.None, Optional states As BlobStates = Azure.Storage.Blobs.Models.BlobStates.None, Optional delimiter As String = Nothing, Optional prefix As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of BlobHierarchyItem)

参数

traits

BlobTraits

指定用于调整 blob 的特征选项。

states

BlobStates

指定用于筛选 Blob 的状态选项。

delimiter

String

一个 delimiter ，可用于遍历 Blob 的虚拟层次结构，就像它是一个文件系统一样。 分隔符可以是单个字符或字符串。 Prefix 将返回 ，以替换其名称以相同子字符串开头的所有 blob，以及分隔符字符的外观。 前缀的值是 substring+delimiter，其中 substring 是开始一个或多个 Blob 名称的常见子字符串，分隔符是 的值 delimiter。 可以使用 prefix 的值进行后续调用，以列出以此前缀开头的 Blob，方法是指定 前缀 prefix的值。

请注意，每个返回的 BlobPrefix 元素都计入最大结果，就像每个 Blob 元素一样。

prefix

String

指定一个字符串，该字符串筛选结果以仅返回其名称以指定 prefix开头的 blob。

cancellationToken

CancellationToken

可选 CancellationToken ，用于传播应取消操作的通知。

返回

AsyncPageable<BlobHierarchyItem>

描述 AsyncPageable<T> 容器中的 Blob 的 。

注解

RequestFailedException如果发生故障，将引发 。