BlobContainerClient.GetBlobsByHierarchyAsync Methode

Definition

Namespace:

Azure.Storage.Blobs

Assembly:

Azure.Storage.Blobs.dll

Paket:

Azure.Storage.Blobs v12.19.1

Quelle:

BlobContainerClient.cs

Der GetBlobsByHierarchyAsync(BlobTraits, BlobStates, String, String, CancellationToken) Vorgang gibt eine asynchrone Auflistung von Blobs in diesem Container zurück. Beim Aufzählen der Blobs können mehrere Anforderungen an den Dienst gesendet werden, während alle Werte abgerufen werden. Blobs werden lexikographisch nach Namen sortiert. Ein delimiter kann verwendet werden, um eine virtuelle Hierarchie von Blobs zu durchlaufen, als wäre es ein Dateisystem.

Weitere Informationen finden Sie unter Auflisten von Blobs.

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)

Parameter

traits

BlobTraits

Gibt Eigenschaftenoptionen zum Strukturieren der Blobs an.

states

BlobStates

Gibt Zustandsoptionen zum Filtern der Blobs an.

delimiter

String

Ein delimiter , das verwendet werden kann, um eine virtuelle Hierarchie von Blobs zu durchlaufen, als wäre es ein Dateisystem. Das Trennzeichen kann ein einzelnes Zeichen oder eine Zeichenfolge sein. Prefix wird anstelle aller Blobs zurückgegeben, deren Namen mit derselben Teilzeichenfolge bis zur Darstellung des Trennzeichens beginnen. Der Wert eines Präfixes ist Teilzeichenfolge+Trennzeichen, wobei teilzeichenfolge die allgemeine Teilzeichenfolge ist, die einen oder mehrere Blobnamen beginnt, und Trennzeichen ist der Wert von delimiter. Sie können den Wert des Präfixes verwenden, um einen nachfolgenden Aufruf zum Auflisten der Blobs zu tätigen, die mit diesem Präfix beginnen, indem Sie den Wert des Präfixes für angeben prefix.

Beachten Sie, dass jedes zurückgegebene BlobPrefix-Element auf das maximale Ergebnis angerechnet wird, genau wie jedes Blob-Element.

prefix

String

Gibt eine Zeichenfolge an, die die Ergebnisse filtert, um nur Blobs zurückzugeben, deren Name mit dem angegebenen prefixbeginnt.

cancellationToken

CancellationToken

Optional CancellationToken zur Weitergabe von Benachrichtigungen, dass der Vorgang abgebrochen werden soll.

Gibt zurück

AsyncPageable<BlobHierarchyItem>

Ein AsyncPageable<T> , der die Blobs im Container beschreibt.

Hinweise

Ein RequestFailedException wird ausgelöst, wenn ein Fehler auftritt.