StorageFolder.TryGetItemAsync(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

Tente d’obtenir le fichier ou le dossier portant le nom spécifié à partir du dossier actif. Retourne null au lieu de déclencher une exception FileNotFoundException si le fichier ou dossier spécifié est introuvable.

public:
 virtual IAsyncOperation<IStorageItem ^> ^ TryGetItemAsync(Platform::String ^ name) = TryGetItemAsync;

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

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

function tryGetItemAsync(name)

Public Function TryGetItemAsync (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é. Si le fichier ou dossier spécifié est introuvable, cette méthode retourne null au lieu de déclencher une exception.

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.IStorageFolder2.TryGetItemAsync(System.String) M:Windows.Storage.IStorageFolder2.TryGetItemAsync(Platform::String) M:Windows.Storage.IStorageFolder2.TryGetItemAsync(winrt::hstring)

Attributs: RemoteAsyncAttribute

Exemples

L’exemple suivant montre comment essayer d’obtenir un seul fichier ou dossier à partir du dossier actif, ou de case activée si le fichier ou le dossier existe, en appelant la méthode TryGetItemAsync.

using Windows.Storage;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to Output window.

// Get the path to the app's Assets folder.
string root = Windows.ApplicationModel.Package.Current.InstalledLocation.Path;
string path = root + @"\Assets";

// Get the app's Assets folder.
StorageFolder assetsFolder = await StorageFolder.GetFolderFromPathAsync(path);

// Check whether an image with the specified scale exists.
string imageName = "Logo.scale-140.png";
if (await assetsFolder.TryGetItemAsync(imageName) != null)
    Debug.WriteLine(imageName + " exists.");
else  // Return value of TryGetItemAsync is null.
    Debug.WriteLine(imageName + " does not exist.");

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    std::wstring imageName{ L"Wide310x150Logo.scale-200.png" };

    // Get the path to the app's Assets folder.
    std::wstring path{ Windows::ApplicationModel::Package::Current().InstalledLocation().Path() + L"\\Assets" };

    // Get the folder object that corresponds to this absolute path in the file system.
    Windows::Storage::StorageFolder assets{ co_await Windows::Storage::StorageFolder::GetFolderFromPathAsync(path) };
    IStorageItem image{ co_await assets.TryGetItemAsync(imageName) };

    std::wstring output;
    if (image)
    {
        output = L"File: " + image.Name() + L" found \n";
    }
    else
    {
        output = L"File not found\n";
    }
    ::OutputDebugString(output.c_str());
}

String^ imageName = "Logo.scale-140.png";
// Get the app'ss Assets folder
String^ path = Windows::ApplicationModel::Package::Current->InstalledLocation->Path + "\\Assets";

create_task(StorageFolder::GetFolderFromPathAsync(path)).then([=](StorageFolder^ assets) -> task < IStorageItem^ > 
{
 return create_task(assets->TryGetItemAsync(imageName));
}).then([=](IStorageItem^ image) {
 String^ output = "";
 if (image == nullptr)
 {
  output = "File not found\n";
 }
 else
 {
  //output = "File: " + image->Name + " found \n";
 }
 OutputDebugString(output->Begin());
});

Remarques

Appelez la méthode TryGetItemAsync 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. Si le fichier ou le dossier est introuvable, TryGetItemAsync retourne null au lieu de déclencher une exception.

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

S’applique à

Voir aussi

GetItemAsync(String)