StorageFolder.GetItemAsync(String) Metodo

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

Restituisce

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

Attributi

RemoteAsyncAttribute

Eccezioni

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 .

Si applica a

Vedi anche

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