StorageFolderQueryResult Classe

  • Référence

Définition

Espace de noms:
Windows.Storage.Search
Modifier

Fournit l’accès aux résultats d’une requête qui répertorie le dossier (ou les groupes de fichiers) dans le dossier interrogé (qui est représenté par un StorageFolder). Vous pouvez utiliser un StorageFolderQueryResult pour énumérer des dossiers ou des groupes de fichiers dans ce dossier.

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
Héritage
Object Platform::Object IInspectable StorageFolderQueryResult
Attributs
ContractVersionAttribute
Implémente
IStorageQueryResultBase

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

Cet exemple montre comment obtenir des dossiers de liste (ou des groupes de fichiers) à partir d’un objet StorageFolderQueryResult.

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

// Set query options to create groups of files within result
QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

La queryResult variable obtient le StorageFolderQueryResult utilisé pour récupérer des groupes de fichiers (ou des dossiers) qui répondent aux critères de la requête.

Notes

Vous avez besoin de la fonctionnalité de bibliothèque d’images pour accéder à la bibliothèque à l’aide de KnownFolders.PicturesLibrary. Pour en savoir plus sur les fonctionnalités et l’accès aux fichiers, consultez Autorisations d’accès aux fichiers.

Remarques

Notes

Bien qu’elle ne soit pas attribuée avec marshalling_behavior(agile), cette classe peut être traitée comme agile. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) .

Vous pouvez obtenir un objet StorageFolderQueryResult en appelant les méthodes suivantes à partir d’un objet StorageFolder ou FolderInformation :

Pour obtenir d’autres exemples de code qui vous montrent comment utiliser des objets storageFolderQueryResult, consultez l’exemple d’énumération Folder.

Pour obtenir un objet StorageFolderQueryResult afin d’énumérer les dossiers ou les groupes de fichiers dans un emplacement, vous devez obtenir un storageFolder qui représente l’emplacement, puis créer une requête de dossier.

Propriétés

Folder

Obtient le dossier utilisé à l’origine pour créer l’objet StorageFolderQueryResult . Ce dossier représente l’étendue de la requête.

Méthodes

ApplyNewQueryOptions(QueryOptions)

Modifie les résultats de la requête en fonction des nouvelles QueryOptions.
FindStartIndexAsync(Object)

Récupère l’index du dossier à partir des résultats de la requête qui correspondent le plus à la valeur de propriété spécifiée. La propriété qui est mise en correspondance est déterminée par le premier SortEntry de la liste QueryOptions.SortOrder .
GetCurrentQueryOptions()

Récupère les options de requête utilisées pour déterminer les résultats de la requête.
GetFoldersAsync()

Récupère une liste de tous les dossiers (ou groupes de fichiers) dans le jeu de résultats.
GetFoldersAsync(UInt32, UInt32)

Récupère des dossiers (ou des groupes de fichiers) dans une plage spécifiée.
GetItemCountAsync()

Récupère le nombre de dossiers (ou groupes de fichiers) dans l’ensemble des résultats de la requête.

Événements

ContentsChanged

Se déclenche lorsqu’un fichier est ajouté, supprimé ou modifié dans le dossier interrogé. Cet événement se déclenche uniquement après que GetFilesAsync a été appelé au moins une fois.
OptionsChanged

Se déclenche lorsque les options de requête changent.

S’applique à

Voir aussi