StorageFolder.GetItemAsync(String) Método

Definição

Namespace:

Windows.Storage

Obtém o arquivo ou pasta com o nome especificado da pasta atual.

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

O nome (ou caminho relativo à pasta atual) do arquivo ou pasta a ser obtido.

Retornos

IAsyncOperation<IStorageItem>

Quando esse método for concluído com êxito, ele retornará um IStorageItem que representa o arquivo ou pasta especificado.

Para trabalhar com o item retornado, chame o método IsOfType da interface IStorageItem para determinar se o item é um arquivo ou uma pasta. Em seguida, converta o item em storageFolder ou StorageFile.

Implementações

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

Atributos

RemoteAsyncAttribute

Exceções

FileNotFoundException

O item especificado não existe. Verifique o valor do nome.

UnauthorizedAccessException

Você não tem permissão para acessar o item especificado. Para obter mais informações, consulte Permissões de acesso a arquivos.

ArgumentException

O caminho não pode estar no formato Uri (por exemplo, /image.jpg). Verifique o valor do nome.

Exemplos

O exemplo a seguir mostra como obter um único arquivo ou pasta da pasta atual chamando o método GetItemAsync . Este exemplo também mostra como obter um item de uma subpasta da pasta atual fornecendo um caminho relativo.

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

Comentários

Chame o método IsOfType da interface IStorageItem para determinar se o item retornado é um arquivo ou uma pasta.

Para obter um arquivo específico sem converter o valor retornado, chame o método GetFileAsync . Para obter uma pasta específica sem converter o valor retornado, chame o método GetFolderAsync .

Para tentar obter um arquivo ou pasta por nome ou para marcar se existe um arquivo ou pasta, sem a necessidade de manipular um FileNotFoundException, chame o método TryGetItemAsync.

Confira também

• GetFileAsync(String)
• GetFolderAsync(String)
• TryGetItemAsync(String)
• Permissões de acesso a arquivo