CommonFolderQuery 枚举

  • 参考

定义

命名空间:
Windows.Storage.Search
编辑

指定如何将文件分组到查询结果中的文件夹中，并确定查询是浅表查询还是深层查询。 深度查询的查询结果包括当前文件夹的所有子文件夹中的所有文件，根据指定的选项分组到文件夹中。

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
继承
Enum
CommonFolderQuery
属性
ContractVersionAttribute

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

根据每个文件的 System.Rating 属性，按) 分级 (1 star、2 星等方式将文件分组到虚拟文件夹中。 每个文件夹将包含所有 (，并且仅) System.Rating 值相同的文件。

只能对库或家庭组文件夹中的文件夹使用此选项。
GroupByTag 109

根据每个文件的 System.Keywords 属性将文件分组到虚拟文件夹中。 每个文件夹将表示一个标记，并包含 其 System.Keywords 向量包含该标记的所有文件。 如果文件在其 System.Keywords 向量中列出多个标记，则它可能会出现在多个生成的文件夹中。

只能对库或家庭组文件夹中的文件夹使用此选项。
GroupByType 111

根据每个文件的 System.ItemTypeText 属性，按类型将文件分组到虚拟文件夹中 (例如，Microsoft Word文档、文本文件等) 。

只能对库或家庭组文件夹中的文件夹使用此选项。
GroupByYear 100

根据每个文件的 System.ItemDate 属性，按年份将文件分组到虚拟文件夹中。 每个文件夹将包含所有 (，并且仅包含同一年内 System.ItemDate 值的) 文件。

只能对库或家庭组文件夹中的文件夹使用此选项。

注解

调用 StorageFolder 类的以下方法之一时，请使用 CommonFolderQuery 枚举中的值。 有关使用 CommonFolderQuery 枚举中的值的示例，请参阅这些方法的主题。

这些方法使用 CommonFolderQuery 枚举中的值来初始化查询的 DateStackOption、 FolderDepth、 IndexerOption 和 SortOrder 选项。

调用 StorageFolder.IsCommonFolderQuerySupported 方法以确定要使用的 CommonFolderQuery 值是否可用于当前文件夹。

提示

当查询基于可具有多个值的属性 (（例如 System.Author) ）将文件分组到虚拟文件夹中时，特定文件可能会出现在多个虚拟文件夹中，因为每个文件夹表示多个值之一。

查询用于对文件进行分组的属性没有值的文件通常从查询结果中排除。

适用于

另请参阅