StorageFolder.CreateFileQuery Méthode

Définition

Espace de noms:

Windows.Storage

Surcharges

CreateFileQuery()	Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif.
CreateFileQuery(CommonFileQuery)	Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif. Obtient également les fichiers à partir des sous-dossiers du dossier actif lorsque la valeur de l’argument de requête est autre que CommonFileQuery.DefaultQuery. Les fichiers sont triés en fonction du CommonFileQuery spécifié.

CreateFileQuery()

Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif.

public:
 virtual StorageFileQueryResult ^ CreateFileQuery() = CreateFileQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFileQueryOverloadDefault")]
StorageFileQueryResult CreateFileQuery();

[Windows.Foundation.Metadata.Overload("CreateFileQueryOverloadDefault")]
public StorageFileQueryResult CreateFileQuery();

function createFileQuery()

Public Function CreateFileQuery () As StorageFileQueryResult

Retours

StorageFileQueryResult

Objet de résultat de requête. Appelez la méthode GetFilesAsync du résultat de la requête pour obtenir la liste plate des fichiers. Cette méthode retourne une liste de type IReadOnlyList<StorageFile>. Chaque fichier est représenté par un élément de type StorageFile.

Implémente

CreateFileQuery()

Attributs

OverloadAttribute

Exemples

L’exemple suivant obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif en appelant la méthode CreateFileQuery().

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

// Get the app's installation folder.
StorageFolder appFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;

// Get the files in the current folder.
StorageFileQueryResult results = appFolder.CreateFileQuery();

// Iterate over the results and print the list of files
// to the Visual Studio Output window.
IReadOnlyList<StorageFile> filesInFolder = await results.GetFilesAsync();
foreach (StorageFile item in filesInFolder)
{
    Debug.WriteLine(item.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the app's installation folder.
    Windows::Storage::StorageFolder appFolder{ Windows::ApplicationModel::Package::Current().InstalledLocation() };
    // Get the files in the current folder.
    Windows::Storage::Search::StorageFileQueryResult results{ appFolder.CreateFileQuery() };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFile> filesInFolder{
        co_await results.GetFilesAsync() };

    // Iterate over the results, and print the list of files to the Visual Studio output window.
    for (StorageFile const& fileInFolder : filesInFolder)
    {
        std::wstring output{ fileInFolder.Name() };
        ::OutputDebugString(output.c_str());
    }
}

//Get the app's installation folder
StorageFolder^ appFolder = Windows::ApplicationModel::Package::Current->InstalledLocation;
//Get the files in the current folder
StorageFileQueryResult^ results = appFolder->CreateFileQuery();

create_task(results->GetFilesAsync()).then([=](IVectorView<StorageFile^>^ filesInFolder) {
 //Iterate over the results and print the list of files
 // to the visual studio output window
 for (auto it = filesInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFile^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

Remarques

Cette requête est une requête superficielle qui retourne uniquement les fichiers dans le dossier actif. Pour obtenir la liste des méthodes qui identifient les requêtes superficielles et les requêtes approfondies, consultez remarques dans la rubrique GetFilesAsync.

Vous pouvez également obtenir une liste de fichiers dans le dossier actif de manière asynchrone en appelant l’une des méthodes GetFilesAsync .

Pour spécifier des options de requête supplémentaires, appelez la méthode CreateFileQueryWithOptions .

Pour obtenir des éléments qui sont des fichiers ou des dossiers, appelez la méthode CreateItemQuery .

Voir aussi

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

Obtient un objet de résultat de requête qui contient les fichiers dans le dossier actif. Obtient également les fichiers à partir des sous-dossiers du dossier actif lorsque la valeur de l’argument de requête est autre que CommonFileQuery.DefaultQuery. Les fichiers sont triés en fonction du CommonFileQuery spécifié.

public:
 virtual StorageFileQueryResult ^ CreateFileQuery(CommonFileQuery query) = CreateFileQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFileQuery")]
StorageFileQueryResult CreateFileQuery(CommonFileQuery const& query);

[Windows.Foundation.Metadata.Overload("CreateFileQuery")]
public StorageFileQueryResult CreateFileQuery(CommonFileQuery query);

function createFileQuery(query)

Public Function CreateFileQuery (query As CommonFileQuery) As StorageFileQueryResult

Paramètres

query

CommonFileQuery

Une des valeurs d’énumération qui spécifie comment trier les fichiers et détermine si la requête est superficielle ou profonde.

Retours

StorageFileQueryResult

Objet de résultat de requête. Appelez la méthode GetFilesAsync du résultat de la requête pour obtenir la liste plate des fichiers, triés comme spécifié par requête. Cette méthode retourne une liste de type IReadOnlyList<StorageFile>. Chaque fichier est représenté par un élément de type StorageFile.

Implémente

CreateFileQuery(CommonFileQuery)

Attributs

OverloadAttribute

Exceptions

ArgumentException

Vous avez spécifié une valeur autre que DefaultQuery à partir de l’énumération <xref:Windows.Storage.Search.CommonFileQuery?text=CommonFileQuery> pour un dossier qui n’est pas un dossier de bibliothèque. Vérifiez la valeur de la requête.

Remarques

Un CommonFileQuery trie rapidement et facilement les fichiers en fonction d’attributs de fichier spécifiques (comme le titre ou la date).

Lorsque vous spécifiez l’option DefaultQuery de l’énumération CommonFileQuery , cette requête est une requête superficielle qui retourne uniquement les fichiers dans le dossier actif. Lorsque vous spécifiez une autre valeur à partir de l’énumération CommonFileQuery , cette requête est une requête approfondie qui retourne une liste aplatie de fichiers du dossier actif et de ses sous-dossiers.

Conseil

Certaines des valeurs de l’énumération CommonFileQuery ne peuvent être utilisées qu’avec un dossier de bibliothèque (comme la bibliothèque Images) ou le dossier de groupe résidentiel. En plus de l’option DefaultQuery , vous pouvez utiliser uniquement les options OrderByName et OrderBySearchRank avec un dossier qui n’est pas un dossier de bibliothèque.

Pour obtenir la liste des méthodes qui identifient les requêtes superficielles et les requêtes approfondies, consultez remarques dans la rubrique GetFilesAsync.

Pour case activée si un CommonFileQuery spécifique est disponible, appelez la méthode IsCommonFileQuerySupported du dossier.

Vous pouvez également obtenir une liste de fichiers dans le dossier actif de manière asynchrone en appelant l’une des méthodes GetFilesAsync .

Pour Windows Server 2012 Vous devez installer des composants d’indexeur pour utiliser certaines valeurs CommonFileQuery , car les composants de l’indexeur ne sont pas installés par défaut.

Voir aussi

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)