StorageFolder.CreateFolderQuery(CommonFolderQuery) | createFolderQuery(CommonFolderQuery) method (Windows)

This topic has not yet been rated - Rate this topic

Creates a query result object to enumerate files in the current folder by grouping them into StorageFolder objects. Files are filtered and grouped based on the specified CommonFolderQuery.

Syntax

JavaScript

C++


var storageFolderQueryResult = storageFolder.createFolderQuery(query);

Parameters

query

Type: CommonFolderQuery

The enum value that identifies how to group files into StorageFolder objects in the query result object.

Return value

Type: StorageFolderQueryResult

A query result object that can be used to filter and enumerate files in the current folder by their StorageFolder.

Remarks

Using a CommonFolderQuery lets you construct lists of folders and file groups based on specific file attributes (like title and date) quickly and easily.

We recommend that you call IsCommonFolderQuerySupported to verify that the CommonFolderQuery you specify is available for the current folder.

For Windows Server 2012: You must install indexer components to use some CommonFolderQuery values because indexer components are not installed by default.

Windows Phone 8

This API is not implemented and will throw an exception if called.

Requirements

Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Minimum supported phone	Windows Phone 8
Namespace	Windows.Storage Windows::Storage [C++]
Metadata	Windows.winmd

StorageFolder.CreateFolderQuery(CommonFolderQuery) | createFolderQuery(CommonFolderQuery) method