StorageFileQueryResult Classe

Référence

Définition

Espace de noms:: Windows.Storage.Search

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

Fournit l’accès aux résultats d’une requête des fichiers à l’emplacement représenté par un objet StorageFolder . Vous pouvez utiliser StorageFileQueryResult pour énumérer les fichiers dans cet emplacement StorageFolder .

public ref class StorageFileQueryResult sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFileQueryResult final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFileQueryResult

Public NotInheritable Class StorageFileQueryResult

Héritage: Object Platform::Object IInspectable StorageFileQueryResult

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 une liste de fichiers à partir d’un objet StorageFileQueryResult.

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Process file
}

La query variable obtient le StorageFileQueryResult utilisé pour récupérer les fichiers 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 à marshalling_behavior(agile), cette classe peut être traitée comme agile.

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

Propriétés

Folder

Obtient le dossier qui a été interrogé pour créer l’objet StorageFileQueryResult . 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 nouveaux QueryOptions.
FindStartIndexAsync(Object)	Récupère l’index du fichier à partir des résultats de la requête qui correspond le plus à la valeur de propriété spécifiée (ou fichier, s’il est utilisé avec FileActivatedEventArgs.NeighboringFilesQuery). 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.
GetFilesAsync()	Récupère une liste de tous les fichiers du jeu de résultats de la requête.
GetFilesAsync(UInt32, UInt32)	Récupère une liste de fichiers dans une plage spécifiée.
GetItemCountAsync()	Récupère le nombre de fichiers dans l’ensemble des résultats de la requête.
GetMatchingPropertiesWithRanges(StorageFile)	Obtient les propriétés de fichier correspondantes avec les plages de texte correspondantes.

É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 l’appel de GetFilesAsync au moins une fois.
OptionsChanged	Se déclenche lorsque les options de requête changent.

S’applique à

Partager via