BlobContainerClient.GetBlobsByHierarchy Méthode

Définition

Espace de noms:

Azure.Storage.Blobs

Assembly:

Azure.Storage.Blobs.dll

Paquet:

Azure.Storage.Blobs v12.19.1

Source:

BlobContainerClient.cs

L’opération GetBlobsByHierarchy(BlobTraits, BlobStates, String, String, CancellationToken) retourne une collection asynchrone d’objets blob dans ce conteneur. L’énumération des objets blob peut effectuer plusieurs requêtes au service lors de l’extraction de toutes les valeurs. Les objets blob sont classés lexicographiquement par nom. Un delimiter peut être utilisé pour parcourir une hiérarchie virtuelle d’objets blob comme s’il s’agissait d’un système de fichiers.

Pour plus d'informations, consultez la rubrique Répertorier les objets 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)

Paramètres

traits

BlobTraits

Spécifie les options de caractéristiques pour la mise en forme des objets blob.

states

BlobStates

Spécifie les options d’état pour filtrer les objets blob.

delimiter

String

delimiter qui peut être utilisé pour parcourir une hiérarchie virtuelle d’objets blob comme s’il s’agissait d’un système de fichiers. Le délimiteur peut être un caractère ou une chaîne. Prefix sera retourné à la place de tous les objets blob dont le nom commence par la même sous-chaîne jusqu’à l’apparence du caractère délimiteur. La valeur d’un préfixe est substring+délimiteur, où substring est la sous-chaîne courante qui commence un ou plusieurs noms d’objets blob, et délimiteur est la valeur de delimiter. Vous pouvez utiliser la valeur de préfixe pour effectuer un appel suivant afin de répertorier les objets blob qui commencent par ce préfixe, en spécifiant la valeur du préfixe pour le prefix.

Notez que chaque élément BlobPrefix retourné compte pour le résultat maximal, comme chaque élément Blob.

prefix

String

Spécifie une chaîne qui filtre les résultats pour renvoyer uniquement les objets blob dont le nom commence par le spécifié prefix.

cancellationToken

CancellationToken

Facultatif CancellationToken pour propager des notifications indiquant que l’opération doit être annulée.

Retours

Pageable<BlobHierarchyItem>

de Pageable<T>BlobHierarchyItem décrire les objets blob dans le conteneur.

Remarques

Un RequestFailedException est levée si une défaillance se produit.