StorageFolder.GetFolderAsync(String) Methode

Referenz

Definition

Namespace:: Windows.Storage

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.

Bearbeiten

Ruft den Unterordner mit dem angegebenen Namen aus dem aktuellen Ordner ab.

public:
 virtual IAsyncOperation<StorageFolder ^> ^ GetFolderAsync(Platform::String ^ name) = GetFolderAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFolder> GetFolderAsync(winrt::hstring const& name);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFolder> GetFolderAsync(string name);

function getFolderAsync(name)

Public Function GetFolderAsync (name As String) As IAsyncOperation(Of StorageFolder)

Parameter

name: String
Platform::String

winrt::hstring

Der Name (oder Pfad relativ zum aktuellen Ordner) des abzurufenden Unterordners.

Gibt zurück

IAsyncOperation<StorageFolder>

Wenn diese Methode erfolgreich abgeschlossen wurde, wird ein StorageFolder zurückgegeben, der den angegebenen Unterordner darstellt.

Implementiert

M:Windows.Storage.IStorageFolder.GetFolderAsync(System.String) M:Windows.Storage.IStorageFolder.GetFolderAsync(Platform::String) M:Windows.Storage.IStorageFolder.GetFolderAsync(winrt::hstring)

Attribute: RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

Der angegebene Ordner ist nicht vorhanden. Überprüfen Sie den Wert von name.

UnauthorizedAccessException

Sie verfügen nicht über die Berechtigung, auf den angegebenen Ordner zuzugreifen. Weitere Informationen finden Sie unter Dateizugriffsberechtigungen.

ArgumentException

Der Pfad darf nicht im URI-Format vorliegen (z. B. /Assets). Überprüfen Sie den Wert von name.

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Unterordner aus dem aktuellen Ordner abrufen, indem Sie die GetFolderAsync-Methode aufrufen. Dieses Beispiel zeigt auch, wie Sie einen Unterordner aus einem Unterordner des aktuellen Ordners abrufen, indem Sie einen relativen Pfad angeben.

using Windows.Storage;
using System.Threading.Tasks;

// Get the app's local folder.
StorageFolder localFolder = ApplicationData.Current.LocalFolder;

// Create 2 levels of subfolders in the app's local folder.
string name1 = "Subfolder1";
StorageFolder subFolder1 = await localFolder.CreateFolderAsync(name1);
string name2 = "Subfolder2";
StorageFolder subFolder2 = await subFolder1.CreateFolderAsync(name2);

// Get the subfolder of the app's local folder.
string level1FolderName = "Subfolder1";
StorageFolder level1Folder = await localFolder.GetFolderAsync(level1FolderName);

// Get the subfolder of the subfolder by providing a relative path.
string level2FolderName = @"Subfolder1\Subfolder2";
StorageFolder level2Folder = await localFolder.GetFolderAsync(level2FolderName);

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the app's local folder.
    Windows::Storage::StorageFolder localFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };

    // Create two levels of subfolders in the app's local folder.
    std::wstring name1{ L"Subfolder1" };
    std::wstring name2{ L"Subfolder2" };
    std::wstring level2FolderName{ L"Subfolder1\\Subfolder2" };

    Windows::Storage::StorageFolder subFolder1{ co_await localFolder.CreateFolderAsync(name1) };
    Windows::Storage::StorageFolder subFolder2{ co_await subFolder1.CreateFolderAsync(name2) };
    // Get the subfolder of the subfolder by providing a relative path.
    Windows::Storage::StorageFolder level2FolderFromRelativePath{ co_await localFolder.GetFolderAsync(level2FolderName) };
}

// Get the app's local folder
StorageFolder^ localFolder = ApplicationData::Current->LocalFolder;

// Create 2 levels of subfolders in the app's local folder.
String^ name1 = "Subfolder1";
String^ name2 = "Subfolder2";
String^ level2FolderName = "Subfolder1\\Subfolder2";

create_task(localFolder->CreateFolderAsync(name1)).then([=](StorageFolder^ subFolder1) -> task <StorageFolder^> {
 return create_task(subFolder1->CreateFolderAsync(name2));
}).then([=](StorageFolder^ subFolder2) -> task<StorageFolder^> {
 // Get the subfolder of the subfolder
 // by providing a relative path.
 return create_task(localFolder->GetFolderAsync(level2FolderName));
});

Gilt für: