StorageFolder.GetFoldersAsync 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.
Overload
| GetFoldersAsync() |
Mendapatkan subfolder dalam folder saat ini. |
| GetFoldersAsync(CommonFolderQuery) |
Mendapatkan subfolder dalam 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 . |
| GetFoldersAsync(CommonFolderQuery, UInt32, UInt32) |
Mendapatkan rentang folder berbasis indeks dari daftar semua 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 . |
GetFoldersAsync()
Mendapatkan subfolder dalam folder saat ini.
public:
virtual IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync() = GetFoldersAsync;/// [Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultOptionsStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync();[Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultOptionsStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync();function getFoldersAsync()Public Function GetFoldersAsync () As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))Mengembalikan
Ketika metode ini berhasil diselesaikan, metode ini mengembalikan daftar subfolder di folder saat ini. Daftar ini berjenis IReadOnlyList<StorageFolder>. Setiap folder dalam daftar diwakili oleh objek StorageFolder .
Penerapan
- Atribut
Pengecualian
Anda tidak memiliki izin untuk mengakses isi folder saat ini. Untuk informasi selengkapnya, lihat Izin akses file.
Contoh
Contoh berikut menunjukkan cara mendapatkan konten subfolder di folder Gambar pengguna, dikelompokkan menurut bulan, dengan memanggil metode GetFoldersAsync(CommonFolderQuery, UInt32, UInt32). (File dari akar folder saat ini tidak disertakan.) Contoh ini mengembalikan maksimum 4 folder, dimulai dengan folder di indeks 0. Karena opsi CommonFolderQuery.GroupByMonth mengurutkan tanggal dalam urutan turun (yaitu, dari yang terbaru ke terlama), contoh ini mengembalikan folder selama 4 bulan terakhir di mana pengguna memiliki foto. Setiap folder berisi semua foto pengguna dari bulan tersebut.
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 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. Get only the first 4 folders (months).
IReadOnlyList <StorageFolder> groupedItems = await picturesFolder.GetFoldersAsync(CommonFolderQuery.GroupByMonth, 0, 4);
// Iterate over the results and print the list of folders
// and files to the Visual Studio Output window.
foreach (StorageFolder folder in groupedItems)
{
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, grouped by month.
// Get only the first 4 folders (months).
Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFolder> itemsInFolder{
co_await picturesFolder.GetFoldersAsync(Windows::Storage::Search::CommonFolderQuery::GroupByMonth, 0, 4) };
// 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 the user's Pictures folder.
// Enable the corresponding capability in the app manifest file.
StorageFolder^ picturesFolder = KnownFolders::PicturesLibrary;
// Get the files in the user's Pictures folder, grouped by month.
// Get only the first 4 folders (months).
create_task(picturesFolder->GetFoldersAsync(CommonFolderQuery::GroupByMonth, 0, 4)).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.
Tabel berikut mencantumkan metode kelas StorageFolder yang mendapatkan daftar subfolder. Tabel mengidentifikasi kueri dangkal yang hanya mengembalikan subfolder dari folder saat ini, dan kueri mendalam yang mengembalikan konten subfolder berlapis, yang dikelompokkan ke dalam folder virtual.
Beberapa metode mengambil nilai dari enumerasi CommonFolderQuery .
- Saat Anda menggunakan opsi DefaultQuery dengan folder apa pun, kueri mengembalikan daftar subfolder dalam sistem file.
- Saat Anda menggunakan opsi selain DefaultQuery dengan folder pustaka, kueri mengembalikan daftar folder virtual yang mewakili kontainer untuk file dari subfolder folder saat ini. (File dari folder saat ini tidak disertakan.) File dikelompokkan ke dalam folder virtual berdasarkan nilai yang ditentukan dari enumerasi CommonFolderQuery . Misalnya, jika Anda menentukan GroupByMonth, kueri mengembalikan daftar folder virtual seperti
July 2014, ,August 2014danSeptember 2014.
Tip
Anda dapat menggunakan opsi DefaultQuery dengan folder apa pun; Anda dapat menggunakan opsi lain dari enumerasi CommonFolderQuery hanya dengan folder pustaka, seperti pustaka Gambar, atau folder Grup Rumah.
Untuk mendapatkan hasil kueri mendalam dari folder yang bukan folder pustaka, panggil metode CreateFolderQueryWithOptions(QueryOptions) dan tentukan Deep sebagai nilai properti FolderDepth dari objek QueryOptions .
| Metode | Membuat kueri dangkal yang hanya mengembalikan subfolder dari folder saat ini | Membuat kueri mendalam yang mengembalikan semua subfolder berlapis |
|---|---|---|
| GetFoldersAsync() | Perilaku default metode ini. | T/A |
| GetFoldersAsync(CommonFileQuery) | Tentukan opsi DefaultQuery . | Untuk folder pustaka, tentukan opsi selain DefaultQuery. |
| GetFoldersAsync(CommonFileQuery, UInt32, UInt32) | Tentukan opsi DefaultQuery . | Untuk folder pustaka, tentukan opsi selain DefaultQuery. |
| CreateFolderQuery() | Perilaku default metode ini. | T/A |
| CreateFolderQuery(CommonFileQuery) | Tentukan opsi DefaultQuery . | Untuk folder pustaka, tentukan opsi selain DefaultQuery. |
| CreateFolderQueryWithOptions(QueryOptions) | Perilaku default metode ini jika tidak ada opsi berikut yang ditentukan. - atau - Tentukan DefaultQuery sebagai nilai CommonFolderQuery saat Anda membuat instans objek QueryOptions . - atau - Tentukan Dangkal sebagai nilai properti FolderDepth dari objek QueryOptions . |
Untuk folder pustaka, tentukan nilai selain DefaultQuery sebagai nilai CommonFolderQuery saat Anda membuat instans objek QueryOptions . - atau - Untuk folder apa pun, tentukan Deep sebagai nilai properti FolderDepth dari QueryOptions. |
Lihat juga
- GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)
- GetFoldersAsync(CommonFolderQuery)
- Izin akses file
- GetItemsAsync
Berlaku untuk
GetFoldersAsync(CommonFolderQuery)
Mendapatkan subfolder dalam 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 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query) = GetFoldersAsync;/// [Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query);[Windows.Foundation.Metadata.Overload("GetFoldersAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query);function getFoldersAsync(query)Public Function GetFoldersAsync (query As CommonFolderQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))Parameter
- query
- CommonFolderQuery
Salah satu nilai enumerasi yang menentukan cara mengelompokkan file ke dalam folder dan menentukan apakah kueri dangkal atau dalam.
Mengembalikan
Ketika metode ini berhasil diselesaikan, metode ini mengembalikan daftar subfolder. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, metode ini mengembalikan 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
- Atribut
Pengecualian
Anda tidak memiliki izin untuk mengakses isi folder saat ini. Untuk informasi selengkapnya, lihat Izin akses file.
Lihat juga
Berlaku untuk
GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)
Mendapatkan rentang folder berbasis indeks dari daftar semua 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 IAsyncOperation<IVectorView<StorageFolder ^> ^> ^ GetFoldersAsync(CommonFolderQuery query, unsigned int startIndex, unsigned int maxItemsToRetrieve) = GetFoldersAsync;/// [Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFolder>> GetFoldersAsync(CommonFolderQuery const& query, uint32_t const& startIndex, uint32_t const& maxItemsToRetrieve);[Windows.Foundation.Metadata.Overload("GetFoldersAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFolder>> GetFoldersAsync(CommonFolderQuery query, uint startIndex, uint maxItemsToRetrieve);function getFoldersAsync(query, startIndex, maxItemsToRetrieve)Public Function GetFoldersAsync (query As CommonFolderQuery, startIndex As UInteger, maxItemsToRetrieve As UInteger) As IAsyncOperation(Of IReadOnlyList(Of StorageFolder))Parameter
- query
- CommonFolderQuery
Salah satu nilai enumerasi yang menentukan cara mengelompokkan file ke dalam folder dan menentukan apakah kueri dangkal atau dalam.
- startIndex
-
UInt32
unsigned int
uint32_t
Indeks berbasis nol dari folder pertama dalam rentang yang akan diambil.
- maxItemsToRetrieve
-
UInt32
unsigned int
uint32_t
Jumlah maksimum folder yang akan diambil.
Mengembalikan
Ketika metode ini berhasil diselesaikan, metode ini mengembalikan daftar subfolder. Ketika nilai argumen kueri adalah sesuatu selain CommonFolderQuery.DefaultQuery, metode ini mengembalikan 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
- Atribut
Pengecualian
Anda tidak memiliki izin untuk mengakses isi folder saat ini. Untuk informasi selengkapnya, lihat Izin akses file.
Lihat juga
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk