Windows.Storage.StorageFolder.GetFolderFromPathAsync

September 27, 2022 ยท View on GitHub

-description

Gets the folder that has the specified absolute path in the file system.

-parameters

-param path

The absolute path in the file system (not the Uri) of the folder to get.

If your path uses slashes, make sure you use backslashes (\). Forward slashes (/) are not accepted by this method.

-returns

When this method completes successfully, it returns a StorageFolder that represents the specified folder.

-exceptions

T:System.IO.FileNotFoundException

The specified folder does not exist. Check the value of path.

T:System.UnauthorizedAccessException

You don't have permission to access the specified folder. For more information, see File access permissions.

T:System.ArgumentException

The path cannot be a relative path or a Uri. Check the value of path.

-remarks

-examples

The following example shows how to get the folder that has the specified absolute path in the file system by calling the GetFolderFromPathAsync method.

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());
});

-see-also

File access permissions