StorageFolder.AreQueryOptionsSupported(QueryOptions) Metode
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.
Menunjukkan apakah folder saat ini mendukung QueryOptions yang ditentukan.
public:
virtual bool AreQueryOptionsSupported(QueryOptions ^ queryOptions) = AreQueryOptionsSupported;
bool AreQueryOptionsSupported(QueryOptions const& queryOptions);
public bool AreQueryOptionsSupported(QueryOptions queryOptions);
function areQueryOptionsSupported(queryOptions)
Public Function AreQueryOptionsSupported (queryOptions As QueryOptions) As Boolean
Parameter
- queryOptions
- QueryOptions
QueryOptions untuk diperiksa.
Mengembalikan
bool
True jika folder atau grup file mendukung QueryOptions yang ditentukan; jika tidak salah.
Penerapan
Keterangan
QueryOptions memungkinkan Anda menghitung file dalam folder dan subfoldernya dengan memungkinkan Anda menentukan kriteria yang kemudian dapat Anda gunakan untuk membuat objek hasil kueri file di folder dan subfolder tersebut. Enumerasi CommonFileQuery dan CommonFolderQuery mewakili beberapa kriteria paling umum yang digunakan untuk memfilter dan menghitung file dan folder.
Gunakan metode AreQueryOptionsSupported untuk memverifikasi bahwa QueryOptions yang ingin Anda tentukan tersedia untuk folder saat ini. Anda juga dapat memeriksa apakah nilai CommonFileQuery atau CommonFolderQuery tertentu tersedia, dengan memanggil IsCommonFileQuerySupported atau IsCommonFolderQuerySupported.
Opsi khusus yang tersedia untuk Anda bergantung pada di mana file atau folder yang ingin Anda hitung berada. Untuk folder dan file yang terletak di dalam pustaka atau grup rumah, Anda bisa menggunakan kombinasi QueryOptions apa pun.
Folder dan file di luar pustaka atau grup rumah hanya mendukung subset opsi.
Untuk kueri yang hanya menghitung file atau folder tingkat atas (juga dikenal sebagai kueri dangkal), buat objek QueryOptions dengan salah satu dari tiga cara berikut:
- Panggil konstruktor QueryOptions() default.
- Panggil konstruktor QueryOptions(CommonFolderQuery) dan tentukan CommonFolderQuery. DefaultQuery.
- Panggil konstruktor QueryOptions(CommonFileQuery, IIterable(String)) dan tentukan CommonFileQuery. DefaultQuery. Anda masih dapat menentukan tipe file yang akan difilter ketika Anda menggunakan konstruktor ini.
Untuk kueri yang menghitung semua file di dalam folder saat ini dan subfoldernya (juga dikenal sebagai kueri mendalam), buat objek QueryOptions dengan salah satu dari dua cara berikut:
- Panggil konstruktor QueryOptions(CommonFolderQuery) dan tentukan CommonFileQuery. OrderByName atau CommonFileQuery. OrderBySearchRank.
- Panggil konstruktor QueryOptions(CommonFileQuery, IIterable(String)) dan tentukan CommonFileQuery. OrderByName atau CommonFileQuery. OrderBySearchRank. Anda masih dapat menentukan tipe file yang akan difilter ketika Anda menggunakan konstruktor ini.
Untuk Windows Server 2012 Anda harus menginstal komponen pengindeks untuk menggunakan beberapa nilai QueryOptions, CommonFileQuery , dan CommonFolderQuery karena komponen pengindeks tidak diinstal secara default.