BlobContainerClient.GetBlobsByHierarchyAsync Methode

Referenz

Definition

Namespace:: Azure.Storage.Blobs

Assembly:: Azure.Storage.Blobs.dll

Paket:: Azure.Storage.Blobs v12.20.0

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

Quelle:: BlobContainerClient.cs

Quelle:: BlobContainerClient.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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.

Gilt für:

Freigeben über