StorageFolder.CreateFolderQuery Metode

Definisi

Ruang nama:

Windows.Storage

Overload

CreateFolderQuery()	Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini.
CreateFolderQuery(CommonFolderQuery)	Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, mendapatkan daftar folder virtual yang mewakili kontainer untuk grup file di subfolder folder saat ini. File dikelompokkan ke dalam folder berdasarkan nilai yang ditentukan dari enumerasi CommonFolderQuery .

CreateFolderQuery()

Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini.

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery() = CreateFolderQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
StorageFolderQueryResult CreateFolderQuery();

[Windows.Foundation.Metadata.Overload("CreateFolderQueryOverloadDefault")]
public StorageFolderQueryResult CreateFolderQuery();

function createFolderQuery()

Public Function CreateFolderQuery () As StorageFolderQueryResult

Mengembalikan

StorageFolderQueryResult

Objek hasil kueri. Panggil metode GetFoldersAsync dari hasil kueri untuk mendapatkan subfolder di folder saat ini. Metode ini mengembalikan daftar jenis IReadOnlyList<StorageFolder>. Setiap file atau folder diwakili oleh item jenis StorageFolder.

Penerapan

CreateFolderQuery()

Atribut

OverloadAttribute

Pengecualian

UnauthorizedAccessException

Anda tidak memiliki izin untuk mengakses isi folder saat ini.

Contoh

Contoh berikut menunjukkan cara mendapatkan konten subfolder di folder Gambar pengguna, dikelompokkan ke dalam folder menurut bulan, dengan memanggil metode kelebihan beban GetFoldersAsync(CommonFolderQuery). (File dari akar folder saat ini tidak disertakan.)

Sebelum Anda menjalankan contoh berikut, aktifkan kemampuan Pustaka Gambar dalam file manifes aplikasi.

using Windows.Storage;
using Windows.Storage.Search;
using System.Threading.Tasks;
using System.Diagnostics; // For writing results to the Output window.

// Get the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder picturesFolder = KnownFolders.PicturesLibrary;

// Get the files in the subfolders of the
// user's Pictures folder, grouped by month.
StorageFolderQueryResult groupedItems =
    picturesFolder.CreateFolderQuery(CommonFolderQuery.GroupByMonth);

// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in await groupedItems.GetFoldersAsync())
{
    Debug.WriteLine(folder.Name);

// To iterate over the files in each folder,
// uncomment the following lines.
// foreach(StorageFile file in await folder.GetFilesAsync())
//    Debug.WriteLine(" " + file.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the users's Pictures folder.
    // Enable the Pictures Library capability in the app manifest file.
    Windows::Storage::StorageFolder picturesFolder{ Windows::Storage::KnownFolders::PicturesLibrary() };

    // Get the files in the user's Pictures folder, and group them by month.
    Windows::Storage::Search::StorageFolderQueryResult results{ picturesFolder.CreateFolderQuery(Windows::Storage::Search::CommonFolderQuery::GroupByMonth) };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFolder> itemsInFolder{
        co_await results.GetFoldersAsync() };

    // Iterate over the results, and print the list of file groups to the Visual Studio output window.
    for (StorageFolder const& itemInFolder : itemsInFolder)
    {
        std::wstring output{ itemInFolder.Name() };
        ::OutputDebugString(output.c_str());
    }
}

// Get user's pictures folder
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;

// Get the files in the user's Pictures folder and group them by month
StorageFolderQueryResult^ itemsInFolder = picturesFolder->CreateFolderQuery(CommonFolderQuery::GroupByMonth);

create_task(itemsInFolder->GetFoldersAsync()).then([=](IVectorView<StorageFolder^>^ itemsInFolder) {
 //Iterate over the results and print the list of file groups
 // to the visual studio output window
 for (auto it = itemsInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFolder^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

Keterangan

Kueri ini adalah kueri dangkal yang hanya mengembalikan subfolder di folder saat ini. Untuk daftar metode yang mengidentifikasi kueri dangkal dan kueri mendalam, lihat Keterangan dalam metode GetFoldersAsync .

Untuk menentukan opsi kueri tambahan, panggil metode CreateFolderQueryWithOptions .

Untuk mendapatkan item yang merupakan file atau folder, panggil metode CreateItemQuery .

Lihat juga

• CreateFolderQuery(CommonFolderQuery)

CreateFolderQuery(CommonFolderQuery)

Mendapatkan objek hasil kueri yang berisi subfolder di folder saat ini. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, mendapatkan daftar folder virtual yang mewakili kontainer untuk grup file di subfolder folder saat ini. File dikelompokkan ke dalam folder berdasarkan nilai yang ditentukan dari enumerasi CommonFolderQuery .

public:
 virtual StorageFolderQueryResult ^ CreateFolderQuery(CommonFolderQuery query) = CreateFolderQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery const& query);

[Windows.Foundation.Metadata.Overload("CreateFolderQuery")]
public StorageFolderQueryResult CreateFolderQuery(CommonFolderQuery query);

function createFolderQuery(query)

Public Function CreateFolderQuery (query As CommonFolderQuery) As StorageFolderQueryResult

Parameter

query

CommonFolderQuery

Salah satu nilai enumerasi yang menentukan cara mengelompokkan file ke dalam folder dan menentukan apakah kueri dangkal atau dalam.

Mengembalikan

StorageFolderQueryResult

Objek hasil kueri. Panggil metode GetFoldersAsync dari hasil kueri untuk mendapatkan subfolder di folder saat ini. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, objek hasil kueri berisi daftar folder virtual yang mewakili kontainer untuk grup file di subfolder folder saat ini. (File dari folder saat ini tidak disertakan.) File dikelompokkan seperti yang ditentukan oleh kueri. Daftar ini berjenis IReadOnlyList<StorageFolder>. Setiap folder dalam daftar diwakili oleh objek StorageFolder .

Penerapan

CreateFolderQuery(CommonFolderQuery)

Atribut

OverloadAttribute

Pengecualian

UnauthorizedAccessException

Anda tidak memiliki izin untuk mengakses isi folder saat ini.

ArgumentException

Anda menentukan nilai selain DefaultQuery dari <enumerasi xref:Windows.Storage.Search.CommonFolderQuery?text=CommonFolderQuery> untuk folder yang bukan folder pustaka. Periksa nilai kueri.

Keterangan

CommonFolderQuery mengelompokkan konten subfolder ke dalam folder berdasarkan atribut file tertentu (seperti artis atau album) dengan cepat dan mudah. Lihat Komentar di halaman metode CreateFileQuery untuk informasi selengkapnya tentang menentukan opsi DefaultQuery .

Lihat juga

• CreateFolderQuery()