StorageFolder.GetItemAsync(String) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Ottiene il file o la cartella con il nome specificato dalla cartella corrente.

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)

Parametri

name

String

Platform::String

winrt::hstring

Nome (o percorso relativo alla cartella corrente) del file o della cartella da ottenere.

Restituisce

IAsyncOperation<IStorageItem>

Al termine di questo metodo, restituisce un oggetto IStorageItem che rappresenta il file o la cartella specificati.

Per usare l'elemento restituito, chiamare il metodo IsOfType dell'interfaccia IStorageItem per determinare se l'elemento è un file o una cartella. Eseguire quindi il cast dell'elemento in un oggetto StorageFolder o StorageFile.

Implementazioni

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

Attributi

RemoteAsyncAttribute

Eccezioni

FileNotFoundException

L'elemento specificato non esiste. Controllare il valore del nome.

UnauthorizedAccessException

Non si dispone dell'autorizzazione per accedere all'elemento specificato. Per altre informazioni, vedere Autorizzazioni di accesso ai file.

ArgumentException

Il percorso non può essere in formato URI, ad esempio /image.jpg. Controllare il valore del nome.

Esempio

Nell'esempio seguente viene illustrato come ottenere un singolo file o una cartella dalla cartella corrente chiamando il metodo GetItemAsync . Questo esempio illustra anche come ottenere un elemento da una sottocartella della cartella corrente fornendo un percorso 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  
});

Commenti

Chiamare il metodo IsOfType dell'interfaccia IStorageItem per determinare se l'elemento restituito è un file o una cartella.

Per ottenere un file specifico senza eseguire il cast del valore restituito, chiamare il metodo GetFileAsync . Per ottenere una cartella specifica senza eseguire il cast del valore restituito, chiamare il metodo GetFolderAsync .

Per provare a ottenere un file o una cartella in base al nome oppure per verificare se esiste un file o una cartella, senza dover gestire un FileNotFoundException, chiamare il metodo TryGetItemAsync .

Vedi anche

• GetFileAsync(String)
• GetFolderAsync(String)
• TryGetItemAsync(String)
• Autorizzazioni di accesso ai file