Esporta (0) Stampa
Espandi tutto
Il contenuto non è disponibile nella lingua di destinazione, ma solo in inglese.

BlobRequestOptions.UseFlatBlobListing Property

Updated: April 24, 2013

[This topic is part of the Microsoft Azure Storage Client Library 1.7, which has been deprecated. See Storage Client Library for the latest version.]

Gets or sets a value indicating whether the blob listing operation will list all blobs in a container in a flat listing, or whether it will list blobs hierarchically, by virtual directory.

Namespace: Microsoft.WindowsAzure.StorageClient
Assembly: Microsoft.WindowsAzure.StorageClient (in Microsoft.WindowsAzure.StorageClient.dll)

Dim instance As BlobRequestOptions
Dim value As Boolean

value = instance.UseFlatBlobListing

instance.UseFlatBlobListing = value

public bool UseFlatBlobListing { get; set; }

Property Value

Type: System.Boolean

True if blobs will be listed in a flat listing; otherwise, false. The default value is false.

The following code example lists blobs in both a virtual hierarchy and a flat listing, and shows some possible results.

static void ListBlobsInVirtualDirectory(Uri blobEndpoint, string accountName, string accountKey)
    //Create service client for credentialed access to the Blob service.
    CloudBlobClient blobClient = 
        new CloudBlobClient(blobEndpoint, new StorageCredentialsAccountAndKey(accountName, accountKey));

    //List blobs in container 'mycontainer' beginning with prefix 'a/', using a hierarchical listing.
    //The results list only blobs directly beneath 'mycontainer/a/'
    foreach (var blobItem in blobClient.ListBlobsWithPrefix("mycontainer/a/"))

    //Hierarchical listing results:


    //List blobs in container 'mycontainer' beginning with prefix 'a/', using a flat listing.
    //The results list all blobs beneath 'mycontainer/a/', even if they are in a subdirectory.
    BlobRequestOptions options = new BlobRequestOptions();
    options.UseFlatBlobListing = true;
    foreach (var blobItem in blobClient.ListBlobsWithPrefix("mycontainer/a/", options))

    //Flat listing results:

This property is applicable only to a request to list blobs.

By default, a blob listing operation lists blobs using a virtual hierarchy. In a hierarchical blob listing, a delimiter character used within blob names is treated as a path separator. The listing operation lists the blobs directly beneath a container or a virtual directory only. The listing operation may return objects of type CloudBlob and type CloudBlobDirectory.

Setting the UseFlatBlobListing to true lists blobs in a flat listing instead of in a virtual hierarchy. In a flat blob listing, all blobs beneath the designated starting point are returned, regardless of their position in a virtual hierarchy. A flat blob listing returns only objects of type CloudBlob.

To include snapshots in the listing, you must use a flat listing.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Development Platforms

Windows Vista, Windows 7, Windows Server 2008, Windows 8.1, Windows Server 2012 R2, Windows 8 and Windows Server 2012


© 2015 Microsoft