StorageFolderQueryResult Kelas

Definisi

Menyediakan akses ke hasil kueri yang mencantumkan folder (atau grup file) dalam folder yang sedang dikueri (yang diwakili oleh StorageFolder). Anda dapat menggunakan StorageFolderQueryResult untuk menghitung folder atau grup file di folder tersebut.

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
Warisan
Object IInspectable StorageFolderQueryResult
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 folder daftar (atau grup file) dari objek StorageFolderQueryResult.

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

// Set query options to create groups of files within result
QueryOptions queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

Variabel queryResult mendapatkan StorageFolderQueryResult yang digunakan untuk mengambil grup file (atau folder) 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. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX).

Anda bisa mendapatkan objek StorageFolderQueryResult dengan memanggil metode berikut dari StorageFolder atau objek FolderInformation :

Untuk contoh kode lainnya yang menunjukkan kepada Anda cara menggunakan objek storageFolderQueryResult, lihat Sampel enumerasi folder.

Untuk mendapatkan objek StorageFolderQueryResult untuk menghitung folder atau grup file di lokasi, Anda harus mendapatkan storageFolder yang mewakili lokasi lalu membuat kueri folder.

Properti

Folder

Mendapatkan folder yang awalnya digunakan untuk membuat objek StorageFolderQueryResult . Folder ini mewakili cakupan kueri.

Metode

ApplyNewQueryOptions(QueryOptions)

Memodifikasi hasil kueri berdasarkan QueryOptions baru.

FindStartIndexAsync(Object)

Mengambil indeks folder dari hasil kueri yang paling cocok dengan nilai properti yang ditentukan. Properti yang cocok ditentukan oleh SortEntry pertama dari daftar QueryOptions.SortOrder .

GetCurrentQueryOptions()

Mengambil opsi kueri yang digunakan untuk menentukan hasil kueri.

GetFoldersAsync()

Mengambil daftar semua folder (atau grup file) dalam tataan hasil.

GetFoldersAsync(UInt32, UInt32)

Mengambil folder (atau grup file) dalam rentang tertentu.

GetItemCountAsync()

Mengambil jumlah folder (atau grup file) dalam kumpulan hasil kueri.

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