IStorageItem2.GetParentAsync Methode

Definition

Namespace:

Windows.Storage

Ruft den übergeordneten Ordner des aktuellen Speicherelements ab.

public:
 IAsyncOperation<StorageFolder ^> ^ GetParentAsync();

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFolder> GetParentAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFolder> GetParentAsync();

function getParentAsync()

Public Function GetParentAsync () As IAsyncOperation(Of StorageFolder)

Gibt zurück

IAsyncOperation<StorageFolder>

Nach Abschluss dieser Methode wird der übergeordnete Ordner als StorageFolder zurückgegeben.

Attribute

RemoteAsyncAttribute

Hinweise

Sie benötigen Zugriff auf das übergeordnete Element, damit die GetParentAsync-Methode erfolgreich ist, indem Sie Bibliotheksfunktionen deklarieren oder einen Ordner auf höherer Ebene in der Zugriffsliste beibehalten. Außerdem gibt diese Methode NULL zurück, wenn Sie nicht zum übergeordneten Element gelangen können, anstatt eine Ausnahme auszulösen.

In diesem Beispiel wird gezeigt, wie Sie den übergeordneten Ordner einer StorageFile-Datei abrufen.

function openParentFolder(file) {
    file.GetParentAsync().done(function (folder) {
        if (folder != null) {
            folder.getItemsAsync(function (items) {
                var list = document.getElementById("parentFolderItemsList");
                items.forEach(function (item) {
                    var listItemElement = document.createElement("li");
                    if (item.isOfType(Windows.Storage.StorageItemTypes.folder)) {
                        listItemElement.textContent = item.name + "\\";
                    } else {
                        listItemElement.textContent = item.name;
                    }
                    list.appendChild(listItemElement);
                });
            });
        } else {
            // Unable to get parent folder
        }
    });
}