StorageFileQueryResult Kelas

  • Referensi

Definisi

Ruang nama:
Windows.Storage.Search
Edit

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
Object Platform::Object IInspectable StorageFileQueryResult
Atribut
ContractVersionAttribute
Penerapan
IStorageQueryResultBase

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 :

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.

Berlaku untuk

Lihat juga