StorageFolder.GetFolderFromPathAsync(String) Метод

Определение

Пространство имен:

Windows.Storage

Возвращает папку с указанным абсолютным путем в файловой системе.

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)

Параметры

path

String

Platform::String

winrt::hstring

Абсолютный путь к получаемой папке в файловой системе (а не URI).

Если в пути используются косые черты, убедитесь, что используются обратные косые черты (\). Косая черта (/) не принимается этим методом.

Возвращаемое значение

IAsyncOperation<StorageFolder>

После успешного завершения этого метода возвращается объект StorageFolder , представляющий указанную папку.

Атрибуты

RemoteAsyncAttribute

Исключения

FileNotFoundException

Указанная папка не существует. Проверьте значение path.

UnauthorizedAccessException

У вас нет разрешения на доступ к указанной папке. Дополнительные сведения см. в разделе Разрешения на доступ к файлам.

ArgumentException

Путь не может быть относительным путем или URI. Проверьте значение path.

Примеры

В следующем примере показано, как получить папку с указанным абсолютным путем в файловой системе, вызвав метод GetFolderFromPathAsync.

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

См. также раздел

• Разрешения на доступ к файлам