StorageFolder.GetFolderFromPathAsync(String) Methode

Definition

Namespace:

Windows.Storage

Ruft den Ordner ab, der über den angegebenen absoluten Pfad im Dateisystem verfügt.

public:
 static IAsyncOperation<StorageFolder ^> ^ GetFolderFromPathAsync(Platform::String ^ path);

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

[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFolder> GetFolderFromPathAsync(string path);

function getFolderFromPathAsync(path)

Public Shared Function GetFolderFromPathAsync (path As String) As IAsyncOperation(Of StorageFolder)

Parameter

path

String

Platform::String

winrt::hstring

Der absolute Pfad im Dateisystem (nicht der Uri) des abzurufenden Ordners.

Wenn Ihr Pfad Schrägstriche verwendet, stellen Sie sicher, dass Sie umgekehrte Schrägstriche (\) verwenden. Schrägstriche (/) werden von dieser Methode nicht akzeptiert.

Gibt zurück

IAsyncOperation<StorageFolder>

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

Attribute

RemoteAsyncAttribute

Ausnahmen

FileNotFoundException

Der angegebene Ordner ist nicht vorhanden. Überprüfen Sie den Wert des Pfads.

UnauthorizedAccessException

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

ArgumentException

Der Pfad darf kein relativer Pfad oder URI sein. Überprüfen Sie den Wert des Pfads.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Ordner mit dem angegebenen absoluten Pfad im Dateisystem abrufen, indem Sie die GetFolderFromPathAsync-Methode aufrufen.

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

// Get the path to the app's Assets folder.
string root = Windows.ApplicationModel.Package.Current.InstalledLocation.Path;
string path = root + @"\Assets";

// Get the folder object that corresponds to this absolute path in the file system.
StorageFolder folder = await StorageFolder.GetFolderFromPathAsync(path);

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the path to the app's Assets folder.
    std::wstring path{ Windows::ApplicationModel::Package::Current().InstalledLocation().Path() + L"\\Assets" };

    // Get the folder object that corresponds to this absolute path in the file system.
    Windows::Storage::StorageFolder folder{ co_await Windows::Storage::StorageFolder::GetFolderFromPathAsync(path) };
    ::OutputDebugString(folder.Name().c_str());
}

// Get the path to the app's installation folder.
String^ root = Windows::ApplicationModel::Package::Current->InstalledLocation->Path;

// Get the folder object that corresponds to
// this absolute path in the file system.
create_task(StorageFolder::GetFolderFromPathAsync(root)).then([=](StorageFolder^ folder){
 String^ output = folder->Name;
 OutputDebugString(output->Begin());
});

Weitere Informationen

• Berechtigungen für den Dateizugriff