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

BlobContainerClient.GetBlobsByHierarchy 方法

定义

命名空间:

Azure.Storage.Blobs

程序集:

Azure.Storage.Blobs.dll

包:

Azure.Storage.Blobs v12.20.0

Source:

BlobContainerClient.cs

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

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

public virtual Azure.Pageable<Azure.Storage.Blobs.Models.BlobHierarchyItem> GetBlobsByHierarchy (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 GetBlobsByHierarchy : Azure.Storage.Blobs.Models.BlobTraits * Azure.Storage.Blobs.Models.BlobStates * string * string * System.Threading.CancellationToken -> Azure.Pageable<Azure.Storage.Blobs.Models.BlobHierarchyItem>
override this.GetBlobsByHierarchy : Azure.Storage.Blobs.Models.BlobTraits * Azure.Storage.Blobs.Models.BlobStates * string * string * System.Threading.CancellationToken -> Azure.Pageable<Azure.Storage.Blobs.Models.BlobHierarchyItem>

Public Overridable Function GetBlobsByHierarchy (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 Pageable(Of BlobHierarchyItem)

参数

traits

BlobTraits

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

states

BlobStates

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

delimiter

String

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

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

prefix

String

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

cancellationToken

CancellationToken

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

返回

Pageable<BlobHierarchyItem>

BlobHierarchyItem描述Pageable<T>容器中 Blob 的 。

注解

RequestFailedException如果失败，将引发 。