StorageFolder.GetItemAsync(String) Méthode

  • Référence

Définition

Espace de noms:
Windows.Storage
Modifier

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

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)

Paramètres

name
String

Platform::String

winrt::hstring

Nom (ou chemin d’accès relatif au dossier actif) du fichier ou dossier à obtenir.

Retours

IAsyncOperation<IStorageItem>

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

Pour utiliser l’élément retourné, appelez la méthode IsOfType de l’interface IStorageItem pour déterminer s’il s’agit d’un fichier ou d’un dossier. Ensuite, effectuez un cast de l’élément en storageFolder ou StorageFile.

Implémente

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

Exceptions

FileNotFoundException

L’élément spécifié n’existe pas. Vérifiez la valeur de name.

UnauthorizedAccessException

Vous n’êtes pas autorisé à accéder à l’élément 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 de name.

Exemples

L’exemple suivant montre comment obtenir un seul fichier ou dossier à partir du dossier actif en appelant la méthode GetItemAsync . Cet exemple montre également comment obtenir un élément à 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.
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  
});

Remarques

Appelez la méthode IsOfType de l’interface IStorageItem pour déterminer si l’élément retourné est un fichier ou un dossier.

Pour obtenir un fichier spécifique sans caster la valeur de retour, appelez la méthode GetFileAsync . Pour obtenir un dossier spécifique sans caster la valeur de retour, appelez la méthode GetFolderAsync .

Pour essayer d’obtenir un fichier ou un dossier par son nom, ou pour case activée si un fichier ou un dossier existe, sans avoir à gérer une exception FileNotFoundException, appelez la méthode TryGetItemAsync.

S’applique à

Voir aussi