StorageFolder.GetItemAsync(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 el archivo o la carpeta con el nombre especificado de la carpeta actual.
public:
virtual IAsyncOperation<IStorageItem ^> ^ GetItemAsync(Platform::String ^ name) = GetItemAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IStorageItem> GetItemAsync(winrt::hstring const& name);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IStorageItem> GetItemAsync(string name);function getItemAsync(name)Public Function GetItemAsync (name As String) As IAsyncOperation(Of IStorageItem)Parámetros
- name
-
String
Platform::String
winrt::hstring
Nombre (o ruta de acceso relativa a la carpeta actual) del archivo o carpeta que se va a obtener.
Devoluciones
Cuando este método se completa correctamente, devuelve un objeto IStorageItem que representa el archivo o la carpeta especificados.
Para trabajar con el elemento devuelto, llame al método IsOfType de la interfaz IStorageItem para determinar si el elemento es un archivo o una carpeta. A continuación, convierta el elemento en storageFolder o StorageFile.
Implementaciones
- Atributos
Excepciones
El elemento especificado no existe. Compruebe el valor del nombre.
No tiene permiso para acceder al elemento especificado. Para obtener más información, consulte Permisos de acceso a archivos.
La ruta de acceso no puede estar en formato URI (por ejemplo, /image.jpg). Compruebe el valor del nombre.
Ejemplos
En el ejemplo siguiente se muestra cómo obtener un único archivo o carpeta de la carpeta actual mediante una llamada al método GetItemAsync . En este ejemplo también se muestra cómo obtener un elemento de una subcarpeta de la carpeta actual proporcionando una ruta de acceso relativa.
using Windows.Storage;
using System.Threading.Tasks;
// Get the app's installation folder.
StorageFolder appFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;
// Get the app's manifest file.
string name = "AppxManifest.xml";
StorageFile manifestFile = (StorageFile)await appFolder.GetItemAsync(name);
// Get a file from a subfolder of the current folder
// by providing a relative path.
string image = @"Assets\Logo.scale-100.png";
StorageFile logoImage = (StorageFile)await appFolder.GetItemAsync(image);
IAsyncAction MainPage::ExampleCoroutineAsync()
{
// Get the app's installation folder.
Windows::Storage::StorageFolder appFolder{ Windows::ApplicationModel::Package::Current().InstalledLocation() };
// Get the app's manifest file from the current folder.
std::wstring name{ L"AppxManifest.xml" };
Windows::Storage::StorageFile manifest{ co_await appFolder.GetItemAsync(name) };
// Do something with the manifest file.
}
// Get the app's installation folder
StorageFolder^ appFolder = Windows::ApplicationModel::Package::Current->InstalledLocation;
// Get the app's manifest file from the current folder
String^ name = "AppxManifest.xml";
create_task(appFolder->GetItemAsync(name)).then([=](IStorageItem^ manifest){
//Do something with the manifest file
});
Comentarios
Llame al método IsOfType de la interfaz IStorageItem para determinar si el elemento devuelto es un archivo o una carpeta.
Para obtener un archivo específico sin convertir el valor devuelto, llame al método GetFileAsync . Para obtener una carpeta específica sin convertir el valor devuelto, llame al método GetFolderAsync .
Para intentar obtener un archivo o una carpeta por nombre, o para comprobar si existe un archivo o una carpeta, sin necesidad de controlar una excepción FileNotFoundException, llame al método TryGetItemAsync .