StorageFolder.GetItemAsync(String) Método

Definición

Espacio de nombres:

Windows.Storage

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

IAsyncOperation<IStorageItem>

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

M:Windows.Storage.IStorageFolder.GetItemAsync(System.String) M:Windows.Storage.IStorageFolder.GetItemAsync(Platform::String) M:Windows.Storage.IStorageFolder.GetItemAsync(winrt::hstring)

Atributos

RemoteAsyncAttribute

Excepciones

FileNotFoundException

El elemento especificado no existe. Compruebe el valor del nombre.

UnauthorizedAccessException

No tiene permiso para acceder al elemento especificado. Para obtener más información, consulte Permisos de acceso a archivos.

ArgumentException

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 .

Consulte también

• GetFileAsync(String)
• GetFolderAsync(String)
• TryGetItemAsync(String)
• Permisos de acceso a archivos