Provides access to the results of a query of the files in the location that is represented by a storageFolder object. You can use storageFileQueryResult to enumerate the files in that storageFolder location.
The StorageFileQueryResult class has these types of members:
The StorageFileQueryResult class has these events.
|ContentsChanged||Fires when a file is added to, deleted from, or modified in the folder being queried.|
|OptionsChanged||Fires when the query options change.|
The StorageFileQueryResult class has these methods. With C#, Visual Basic, and C++, it also inherits methods from the Object class.
|ApplyNewQueryOptions||Modifies query results based on new QueryOptions.|
|FindStartIndexAsync||Retrieves the index of the file from the query results that most closely matches the specified property value (or file, if used with FileActivatedEventArgs.NeighboringFilesQuery). The property that is matched is determined by the first SortEntry of the QueryOptions.SortOrder list.|
|GetCurrentQueryOptions||Retrieves the query options used to determine query results.|
|GetFilesAsync()||Retrieves a list of all the files in the query result set.|
|GetFilesAsync(UInt32, UInt32)||Retrieves a list of files in a specified range.|
|GetItemCountAsync||Retrieves the number of files in the set of query results.|
|GetMatchingPropertiesWithRanges||Gets matching file properties with corresponding text ranges.|
The StorageFileQueryResult class has these properties.
|Read-only||Gets the folder that was queried to create the StorageFileQueryResult object. This folder represents the scope of the query.|
Note Although it's not attributed with
marshalling_behavior(agile), this class can be treated as agile. For more info, see Threading and Marshaling (C++/CX).
- storageFolder.createFileQuery methods
- storageFolder.createFileQueryWithOptions method
- folderInformation.createFileQuery methods
This API is not implemented and will throw an exception if called. See Windows Phone Runtime API.
This example demonstrates how to get a list of files from a storageFileQueryResult object.
query variable gets the storageFileQueryResult that is used to retrieve files that meet the criteria of the query.
Note You need the Pictures library capability to access the library using KnownFolders.PicturesLibrary. To learn more about capabilities and file access, see File access and permissions in Windows Store app.
Minimum supported client
|Windows 8 [Windows Store apps only]|
Minimum supported server
|Windows Server 2012 [Windows Store apps only]|
Minimum supported phone
|Windows Phone 8 [not implemented, see Remarks]|
- Windows.Storage.storageFolder.createFileQuery methods
- Windows.Storage.storageFolder.createFileQueryWithOptions method