Partager via


BlobContainerClient.GetBlobsByHierarchyAsync Méthode

Définition

L’opération GetBlobsByHierarchyAsync(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.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)

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

AsyncPageable<T> décrivant les objets blob dans le conteneur.

Remarques

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

S’applique à