Provides access to the results of a query that lists the folder (or file groups) in the folder being queried (which is represented by a storageFolder). You can use a storageFolderQueryResult to enumerate folders or file groups in that folder.
Public NotInheritable Class StorageFolderQueryResult Implements IStorageQueryResultBase
The StorageFolderQueryResult class has these types of members:
The StorageFolderQueryResult 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 StorageFolderQueryResult 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 folder from the query results that most closely matches the specified property value. 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.|
|GetFoldersAsync()||Retrieves a list of all the folders (or file groups) in the result set.|
|GetFoldersAsync(UInt32, UInt32)||Retrieves folders (or file groups) in a specified range.|
|GetItemCountAsync||Retrieves the number of folders (or file groups) in the set of query results.|
The StorageFolderQueryResult class has these properties.
|Read-only||Gets the folder originally used to create the StorageFolderQueryResult object.|
- storageFolder.createFolderQuery methods
- storageFolder.createFolderQueryWithOptions method
- folderInformation.createFolderQuery methods
- folderInformation.createFolderQueryWithOptions method
For more code examples that show you how to use storageFolderQueryResult objects, see the Folder enumeration sample.
To get a StorageFolderQueryResult object to enumerate the folders or file groups in a location, you must get a storageFolder that represents the location and then create a folder query
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 folders (or file groups) from a storageFolderQueryResult object.
queryResult variable gets the storageFolderQueryResult that is used to retrieve file groups (or folders) 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 file picker.
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.createFolderQuery methods
- Windows.Storage.storageFolder.createFolderQueryWithOptions method
- Windows.Storage.BulkAccess.folderInformation.createFolderQuery methods
- Windows.Storage.BulkAccess.folderInformation.createFolderQueryWithOptions method
Build date: 11/16/2013