Поделиться через


CommonFolderQuery Перечисление

Определение

Указывает, как группировать файлы в папки в результатах запроса и определяет, является ли запрос неглубоким или глубоким. Результаты запроса для глубоких запросов включают все файлы во всех вложенных папках текущей папки, сгруппированные в папки в соответствии с указанным параметром.

public enum class CommonFolderQuery
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CommonFolderQuery
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CommonFolderQuery
var value = Windows.Storage.Search.CommonFolderQuery.defaultQuery
Public Enum CommonFolderQuery
Наследование
CommonFolderQuery
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Поля

DefaultQuery 0

Неполный список папок в текущей папке, аналогичный представлению, которое предоставляет проводник.

Этот параметр можно использовать для любого расположения хранилища.

GroupByAlbum 103

Группирование файлов в виртуальные папки по годам на основе свойства System.Music.AlbumTitle каждого файла. Каждая папка будет содержать все (и только) файлы с одинаковыми значениями для System.Music.AlbumTitle.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByAlbumArtist 104

Группирование файлов в виртуальные папки на основе свойства System.Music.AlbumArtist каждого файла. Каждая папка будет содержать все (и только) файлы с одинаковыми значениями для System.Music.AlbumArtist.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByArtist 102

Группирование файлов в виртуальные папки на основе свойства System.Music.Artist каждого файла. Каждая папка будет содержать все (и только) файлы с одинаковыми значениями для System.Music.Artist.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByAuthor 110

Группирование файлов в виртуальные папки на основе свойства System.Author каждого файла. Каждая папка будет представлять одного автора и содержать все файлы, в которых вектор System.Author содержит этого автора. Если файл содержит несколько авторов, он может отображаться в нескольких результирующей папке.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByComposer 105

Группирование файлов в виртуальные папки на основе свойства System.Music.Composer каждого файла. Каждая папка будет представлять одного композитора и содержать все файлы, в которых вектор System.Music.Composer содержит этого композитора. Если файл содержит несколько композиторов, он может отображаться в нескольких результирующей папке.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByGenre 106

Группирование файлов в виртуальные папки на основе свойства System.Music.Genre каждого файла. Каждая папка будет содержать все (и только) файлы с одинаковыми значениями для System.Music.Genre.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByMonth 101

Группирование файлов в виртуальные папки по месяцам на основе свойства System.ItemDate каждого файла. Каждая папка будет содержать все (и только) файлы со значениями System.ItemDate в течение одного месяца.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByPublishedYear 107

Группирование файлов в виртуальные папки по годам на основе свойства System.Media.Year каждого файла. Каждая папка будет содержать все (и только) файлы со значениями System.Media.Year в пределах одного года.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByRating 108

Группирование файлов в виртуальные папки по оценке (1 star, 2 звезды и т. д.) на основе свойства System.Rating каждого файла. Каждая папка будет содержать все (и только) файлы с одинаковыми значениями для System.Rating.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByTag 109

Группирование файлов в виртуальные папки на основе свойства System.Keywords каждого файла. Каждая папка будет представлять один тег и содержать все файлы, в которых вектор System.Keywords содержит этот тег. Если файл содержит несколько тегов в его векторе System.Keywords , он может отображаться в нескольких результирующей папке.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByType 111

Группирование файлов в виртуальные папки по типу (например, документы Microsoft Word, текстовые файлы и т. д.) на основе свойства System.ItemTypeText каждого файла.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

GroupByYear 100

Группирование файлов в виртуальные папки по годам на основе свойства System.ItemDate каждого файла. Каждая папка будет содержать все (и только) файлы со значениями System.ItemDate в течение одного года.

Этот параметр можно использовать только для папок в библиотеке или папке Домашней группы.

Комментарии

Используйте значение из перечисления CommonFolderQuery при вызове одного из следующих методов класса StorageFolder . Примеры использования значений из перечисления CommonFolderQuery см. в разделах об этих методах.

Эти методы используют значение перечисления CommonFolderQuery для инициализации параметров DateStackOption, FolderDepth, IndexerOption и SortOrder запроса.

Вызовите метод StorageFolder.IsCommonFolderQuerySupported , чтобы определить, доступно ли значение CommonFolderQuery для текущей папки.

Совет

Когда запрос группирует файлы в виртуальные папки на основе свойства, которое может иметь несколько значений (например, System.Author), определенный файл может отображаться в нескольких виртуальных папках, так как каждая папка представляет одно из нескольких значений.

Файлы, у которых нет значения свойства, которое запрос использует для группирования файлов, обычно исключаются из результатов запроса.

Применяется к

См. также раздел