StorageFolder.GetFileAsync(String) Metodo

Definizione

Spazio dei nomi:

Windows.Storage

Ottiene il file con il nome specificato dalla cartella corrente.

public:
 virtual IAsyncOperation<StorageFile ^> ^ GetFileAsync(Platform::String ^ name) = GetFileAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> GetFileAsync(winrt::hstring const& name);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> GetFileAsync(string name);

function getFileAsync(name)

Public Function GetFileAsync (name As String) As IAsyncOperation(Of StorageFile)

Parametri

name

String

Platform::String

winrt::hstring

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

Restituisce

IAsyncOperation<StorageFile>

Al termine di questo metodo, restituisce un File di archiviazione che rappresenta il file specificato.

Implementazioni

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

Attributi

RemoteAsyncAttribute

Eccezioni

FileNotFoundException

Il file specificato non esiste. Controllare il valore del nome.

UnauthorizedAccessException

Non si dispone dell'autorizzazione per accedere al file 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 file dalla cartella corrente chiamando il metodo GetFileAsync. Questo esempio illustra anche come ottenere un file 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 from the current folder.
string name = "AppxManifest.xml";
StorageFile manifestFile = await appFolder.GetFileAsync(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 = await appFolder.GetFileAsync(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.GetFileAsync(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->GetFileAsync(name)).then([=](StorageFile^ manifest){
 //Do something with the manifest file  
});

Commenti

Per ottenere un elemento che è un file o una cartella, chiamare il metodo GetItemAsync .

Vedi anche

• GetItemAsync(String)
• Autorizzazioni di accesso ai file