CommonFolderQuery Enum
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
-
CommonFolderQuery
- Atribut
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.