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具有相同值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByAlbumArtist 104

根據每個檔案 的 System.Music.AlbumArtist 屬性，將檔案分組成虛擬資料夾。 每個資料夾都會包含所有 (，而且只會) System.Music.AlbumArtist具有相同值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByArtist 102

根據每個檔案 的 System.Music.Artist 屬性，將檔案分組成虛擬資料夾。 每個資料夾都會包含所有 (，而且只會) System.Music.Artist具有相同值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByAuthor 110

根據每個檔案的 System.Author 屬性，將檔案分組為虛擬資料夾。 每個資料夾都會代表一位作者，並包含 System.Author 向量包含該作者的所有檔案。 如果檔案列出多個作者，它可能會出現在多個產生的資料夾中。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByComposer 105

根據每個檔案的 System.Music.Composer 屬性，將檔案分組為虛擬資料夾。 每個資料夾都會代表一個 Composer，並包含 System.Music.Composer 向量包含該 Composer 的所有檔案。 如果檔案列出多個撰寫器，它可能會出現在多個產生的資料夾中。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByGenre 106

根據每個檔案的 System.Music.Genre 屬性，將檔案分組為虛擬資料夾。 每個資料夾都會包含所有 (，而且只會) System.Music.Genre具有相同值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByMonth 101

根據每個檔案的 System.ItemDate 屬性，依月份將檔案分組為虛擬資料夾。 每個資料夾都會包含所有 (，而且只會) 具有相同月份 內 System.ItemDate 值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByPublishedYear 107

根據每個檔案的 System.Media.Year 屬性，依年份將檔案分組為虛擬資料夾。 每個資料夾都會包含所有 (，而且只會) 在同一年內具有 System.Media.Year 值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByRating 108

根據每個檔案的System.Rating屬性，將檔案分組為虛擬資料夾 (1 star、2 顆星) 等。 每個資料夾都會包含所有 (，而且只會) System.Rating具有相同值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByTag 109

根據每個檔案的 System.Keywords 屬性，將檔案分組為虛擬資料夾。 每個資料夾都會代表一個標記，並包含 System.Keywords 向量包含該標籤的所有檔案。 如果檔案在其 System.Keywords 向量中列出多個標記，它可能會出現在多個產生的資料夾中。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByType 111

根據每個檔案的System.ItemTypeText屬性，依類型 (將檔案分組為虛擬資料夾，例如 Microsoft Word檔、文字檔) 等等。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。
GroupByYear 100

根據每個檔案的 System.ItemDate 屬性，依年份將檔案分組為虛擬資料夾。 每個資料夾都會包含所有 (，而且只會) 同一年內具有 System.ItemDate 值的檔案。

您只能針對文件庫或 HomeGroup 資料夾中的資料夾使用此選項。

備註

當您呼叫 StorageFolder 類別的下列其中一種方法時，請使用 CommonFolderQuery 列舉中的值。 如需使用 CommonFolderQuery 列舉值範例，請參閱這些方法的主題。

這些方法會使用 CommonFolderQuery 列舉中的值，初始化查詢的 DateStackOption、 FolderDepth、 IndexerOption和 SortOrder 選項。

呼叫 StorageFolder.IsCommonFolderQuerySupported 方法，以判斷您要使用的 CommonFolderQuery 值是否可用於目前資料夾。

提示

當查詢根據屬性將檔案分組為虛擬資料夾時，可以有多個值 (例如 System.Author) ，特定檔案可能會出現在多個虛擬資料夾中，因為每個資料夾都代表多個值之一。

查詢用來將檔案分組的屬性沒有值的檔案通常會從查詢結果中排除。

適用於

另請參閱