BlobContainerClient.GetBlobsByHierarchyAsync Méthode

Référence

Définition

Espace de noms:: Azure.Storage.Blobs

Assembly:: Azure.Storage.Blobs.dll

Paquet:: Azure.Storage.Blobs v12.20.0

Paquet:: Azure.Storage.Blobs v12.21.0-beta.1

Source:: BlobContainerClient.cs

Source:: BlobContainerClient.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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<BlobHierarchyItem>

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

Remarques

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

S’applique à

Partager via