StorageFolder.GetFileAsync(String) Méthode

Référence

Définition

Espace de noms:: Windows.Storage

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Obtient le fichier portant le nom spécifié à partir du dossier actif.

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)

Paramètres

name: String
Platform::String

winrt::hstring

Nom (ou chemin relatif au dossier actif) du fichier à obtenir.

Retours

IAsyncOperation<StorageFile>

Lorsque cette méthode se termine correctement, elle retourne un StorageFile qui représente le fichier spécifié.

Implémente

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

Attributs: RemoteAsyncAttribute

Exceptions

FileNotFoundException

Le fichier spécifié n'existe pas. Vérifiez la valeur du nom.

UnauthorizedAccessException

Vous n’avez pas l’autorisation d’accéder au fichier spécifié. Pour plus d’informations, consultez Autorisations d’accès aux fichiers.

ArgumentException

Le chemin d’accès ne peut pas être au format URI (par exemple, /image.jpg). Vérifiez la valeur du nom.

Exemples

L’exemple suivant montre comment obtenir un fichier à partir du dossier actif en appelant la méthode GetFileAsync. Cet exemple montre également comment obtenir un fichier à partir d’un sous-dossier du dossier actif en fournissant un chemin relatif.

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

Remarques

Pour obtenir un élément qui est un fichier ou un dossier, appelez la méthode GetItemAsync .

S’applique à

Partager via