StorageFileQueryResult Kelas
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.
Menyediakan akses ke hasil kueri file di lokasi yang diwakili oleh objek StorageFolder . Anda dapat menggunakan StorageFileQueryResult untuk menghitung file di lokasi StorageFolder tersebut.
public ref class StorageFileQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFileQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFileQueryResult
Public NotInheritable Class StorageFileQueryResult
- Warisan
- Atribut
- Penerapan
Persyaratan Windows
Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
|
Contoh
Contoh ini menunjukkan cara mendapatkan daftar file dari objek StorageFileQueryResult.
// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);
// Create query and retrieve files
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
// Process file
}
Variabel query
mendapatkan StorageFileQueryResult yang digunakan untuk mengambil file yang memenuhi kriteria kueri.
Catatan
Anda memerlukan kapabilitas pustaka Gambar untuk mengakses pustaka menggunakan KnownFolders.PicturesLibrary. Untuk mempelajari selengkapnya tentang kapabilitas dan akses file, lihat Izin akses file.
Keterangan
Catatan
Meskipun tidak dikaitkan dengan marshalling_behavior(agile)
, kelas ini dapat diperlakukan sebagai gesit.
Anda bisa mendapatkan objek StorageFileQueryResult dengan memanggil metode berikut dari StorageFolder atau objek FolderInformation :
- Metode StorageFolder.CreateFileQuery
- Metode StorageFolder.CreateFileQueryWithOptions
- Metode FolderInformation.CreateFileQuery
- FolderInformation.CreateFileQueryWithOptions
Properti
Folder |
Mendapatkan folder yang dikueri untuk membuat objek StorageFileQueryResult . Folder ini mewakili cakupan kueri. |
Metode
ApplyNewQueryOptions(QueryOptions) |
Memodifikasi hasil kueri berdasarkan QueryOptions baru. |
FindStartIndexAsync(Object) |
Mengambil indeks file dari hasil kueri yang paling cocok dengan nilai properti yang ditentukan (atau file, jika digunakan dengan FileActivatedEventArgs.NeighboringFilesQuery). Properti yang cocok ditentukan oleh SortEntry pertama dari daftar QueryOptions.SortOrder . |
GetCurrentQueryOptions() |
Mengambil opsi kueri yang digunakan untuk menentukan hasil kueri. |
GetFilesAsync() |
Mengambil daftar semua file dalam tataan hasil kueri. |
GetFilesAsync(UInt32, UInt32) |
Mengambil daftar file dalam rentang tertentu. |
GetItemCountAsync() |
Mengambil jumlah file dalam kumpulan hasil kueri. |
GetMatchingPropertiesWithRanges(StorageFile) |
Mendapatkan properti file yang cocok dengan rentang teks yang sesuai. |
Acara
ContentsChanged |
Diaktifkan saat file ditambahkan ke, dihapus dari, atau dimodifikasi dalam folder yang sedang dikueri. Kejadian ini hanya diaktifkan setelah GetFilesAsync dipanggil setidaknya sekali. |
OptionsChanged |
Diaktifkan saat opsi kueri berubah. |