StorageFolder.GetFolderAsync(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene la subcarpeta con el nombre especificado de la carpeta actual.
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)Parámetros
- name
-
String
Platform::String
winrt::hstring
Nombre (o ruta de acceso relativa a la carpeta actual) de la subcarpeta que se va a obtener.
Devoluciones
Cuando este método se completa correctamente, devuelve una clase StorageFolder que representa la subcarpeta especificada.
Implementaciones
- Atributos
Excepciones
La carpeta especificada no existe. Compruebe el valor del nombre.
No tiene permiso para acceder a la carpeta especificada. Para obtener más información, consulte Permisos de acceso a archivos.
La ruta de acceso no puede estar en formato URI (por ejemplo, /Assets). Compruebe el valor del nombre.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener una subcarpeta de la carpeta actual llamando al método GetFolderAsync. En este ejemplo también se muestra cómo obtener una subcarpeta de una subcarpeta de la carpeta actual proporcionando una ruta de acceso relativa.
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));
});