StorageFolder.GetFolderFromPathAsync(String) Método

Definición

Espacio de nombres:

Windows.Storage

Obtiene la carpeta que tiene la ruta de acceso absoluta especificada en el sistema de archivos.

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)

Parámetros

path

String

Platform::String

winrt::hstring

Ruta de acceso absoluta en el sistema de archivos (no el URI) de la carpeta que se va a obtener.

Si la ruta de acceso usa barras diagonales diagonales inversas (\). Este método no acepta barras diagonales (/).

Devoluciones

IAsyncOperation<StorageFolder>

Cuando este método se completa correctamente, devuelve una clase StorageFolder que representa la carpeta especificada.

Atributos

RemoteAsyncAttribute

Excepciones

FileNotFoundException

La carpeta especificada no existe. Compruebe el valor de la ruta de acceso.

UnauthorizedAccessException

No tiene permiso para acceder a la carpeta especificada. Para obtener más información, consulte Permisos de acceso a archivos.

ArgumentException

La ruta de acceso no puede ser una ruta de acceso relativa ni un URI. Compruebe el valor de la ruta de acceso.

Ejemplos

En el ejemplo siguiente se muestra cómo obtener la carpeta que tiene la ruta de acceso absoluta especificada en el sistema de archivos mediante una llamada al método 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());
});

Consulte también

• Permisos de acceso a archivos