StorageFolder.TryGetItemAsync(String) Méthode

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

Retours

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

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)