CommonFolderQuery Enum

Definisi

Ruang nama:

Windows.Storage.Search

Menentukan cara mengelompokkan file ke dalam folder dalam hasil kueri dan menentukan apakah kueri dangkal atau dalam. Hasil kueri untuk kueri mendalam mencakup semua file di semua subfolder folder saat ini, dikelompokkan ke dalam folder sesuai dengan opsi yang ditentukan.

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

Warisan

Enum

CommonFolderQuery

Atribut

ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Bidang

DefaultQuery	0	Daftar folder yang dangkal di folder saat ini, mirip dengan tampilan yang disediakan File Explorer. Anda dapat menggunakan opsi ini untuk lokasi penyimpanan apa pun.
GroupByAlbum	103	Kelompokkan file ke dalam folder virtual menurut tahun berdasarkan properti System.Music.AlbumTitle dari setiap file. Setiap folder akan berisi semua (dan hanya) file dengan nilai yang identik untuk System.Music.AlbumTitle. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByAlbumArtist	104	Kelompokkan file ke dalam folder virtual berdasarkan properti System.Music.AlbumArtist dari setiap file. Setiap folder akan berisi semua (dan hanya) file dengan nilai yang identik untuk System.Music.AlbumArtist. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByArtist	102	Kelompokkan file ke dalam folder virtual berdasarkan properti System.Music.Artist dari setiap file. Setiap folder akan berisi semua (dan hanya) file dengan nilai yang identik untuk System.Music.Artist. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByAuthor	110	Kelompokkan file ke dalam folder virtual berdasarkan properti System.Author dari setiap file. Setiap folder akan mewakili satu penulis, dan berisi semua file yang vektor System.Author berisi penulis tersebut. Jika file mencantumkan beberapa penulis, file mungkin muncul di lebih dari salah satu folder yang dihasilkan. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByComposer	105	Kelompokkan file ke dalam folder virtual berdasarkan properti System.Music.Composer dari setiap file. Setiap folder akan mewakili satu komposer, dan berisi semua file yang vektor System.Music.Composer berisi komposer tersebut. Jika file mencantumkan beberapa komposer, file mungkin muncul di lebih dari salah satu folder yang dihasilkan. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByGenre	106	Kelompokkan file ke dalam folder virtual berdasarkan properti System.Music.Genre dari setiap file. Setiap folder akan berisi semua (dan hanya) file dengan nilai yang identik untuk System.Music.Genre. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByMonth	101	Kelompokkan file ke dalam folder virtual menurut bulan berdasarkan properti System.ItemDate dari setiap file. Setiap folder akan berisi semua (dan hanya) file yang memiliki nilai untuk System.ItemDate dalam bulan yang sama. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByPublishedYear	107	Kelompokkan file ke dalam folder virtual menurut tahun berdasarkan properti System.Media.Year dari setiap file. Setiap folder akan berisi semua (dan hanya) file yang memiliki nilai untuk System.Media.Year dalam tahun yang sama. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByRating	108	Kelompokkan file ke dalam folder virtual menurut peringkat (1 star, 2 bintang, dan sebagainya) berdasarkan properti System.Rating dari setiap file. Setiap folder akan berisi semua (dan hanya) file dengan nilai yang identik untuk System.Rating. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByTag	109	Kelompokkan file ke dalam folder virtual berdasarkan properti System.Keywords dari setiap file. Setiap folder akan mewakili satu tag, dan berisi semua file yang vektor System.Keywords berisi tag tersebut. Jika file mencantumkan beberapa tag di vektor System.Keywords-nya , file mungkin muncul di lebih dari salah satu folder yang dihasilkan. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByType	111	Kelompokkan file ke dalam folder virtual menurut jenis (misalnya, Microsoft Word dokumen, file teks, dan sebagainya) berdasarkan properti System.ItemTypeText dari setiap file. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.
GroupByYear	100	Kelompokkan file ke dalam folder virtual menurut tahun berdasarkan properti System.ItemDate dari setiap file. Setiap folder akan berisi semua (dan hanya) file yang memiliki nilai untuk System.ItemDate dalam tahun yang sama. Anda dapat menggunakan opsi ini hanya untuk folder dalam pustaka atau folder GrupRumah.

Keterangan

Gunakan nilai dari enumerasi CommonFolderQuery saat Anda memanggil salah satu metode kelas StorageFolder berikut. Untuk contoh yang menggunakan nilai dari enumerasi CommonFolderQuery, lihat topik untuk metode ini.

• CreateFolderQuery(CommonFolderQuery)
• CreateFolderQueryWithOptions. Buat instans QueryOptions dengan konstruktor QueryOptions (CommonFolderQuery).
• CreateItemQueryWithOptions. Buat instans QueryOptions dengan konstruktor QueryOptions (CommonFolderQuery).
• GetFoldersAsync(CommonFolderQuery)
• GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

Metode ini menggunakan nilai dari enumerasi CommonFolderQuery untuk menginisialisasi opsi DateStackOption, FolderDepth, IndexerOption, dan SortOrder kueri.

Panggil metode StorageFolder.IsCommonFolderQuerySupported untuk menentukan apakah nilai CommonFolderQuery yang ingin Anda gunakan tersedia untuk folder saat ini.

Tip

Saat kueri mengelompokkan file ke dalam folder virtual berdasarkan properti yang dapat memiliki beberapa nilai (misalnya, System.Author), file tertentu mungkin muncul di lebih dari satu folder virtual karena setiap folder mewakili salah satu dari beberapa nilai.

File yang tidak memiliki nilai untuk properti yang digunakan kueri untuk mengelompokkan file biasanya dikecualikan dari hasil kueri.

Lihat juga

• QueryOptions(CommonFolderQuery)
• StorageFolder
• Sampel enumerasi folder (Windows 10)