StorageFolder.GetFoldersAsync Metode

Referensi

Definisi

Ruang nama:: Windows.Storage

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()

Edit

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

IAsyncOperation<IVectorView<StorageFolder>>

IAsyncOperation<IReadOnlyList<StorageFolder>>

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

GetFoldersAsync()

Atribut: OverloadAttribute RemoteAsyncAttribute

Pengecualian

UnauthorizedAccessException

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 2014dan September 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

Berlaku untuk

GetFoldersAsync(CommonFolderQuery)

Edit

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

IAsyncOperation<IVectorView<StorageFolder>>

IAsyncOperation<IReadOnlyList<StorageFolder>>

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

GetFoldersAsync(CommonFolderQuery)

Atribut: OverloadAttribute RemoteAsyncAttribute

Pengecualian

UnauthorizedAccessException

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)

Edit

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

IAsyncOperation<IVectorView<StorageFolder>>

IAsyncOperation<IReadOnlyList<StorageFolder>>

Penerapan

M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFoldersAsync(Windows.Storage.Search.CommonFolderQuery,System.UInt32,System.UInt32) M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFoldersAsync(Windows.Storage.Search.CommonFolderQuery,unsigned int,unsigned int) M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFoldersAsync(Windows.Storage.Search.CommonFolderQuery,uint32_t,uint32_t)

Atribut: OverloadAttribute RemoteAsyncAttribute

Pengecualian

UnauthorizedAccessException

Anda tidak memiliki izin untuk mengakses isi folder saat ini. Untuk informasi selengkapnya, lihat Izin akses file.

Lihat juga

Berlaku untuk

Bagikan melalui

StorageFolder.GetFoldersAsync Metode

Definisi

Overload

GetFoldersAsync()

Mengembalikan

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

GetFoldersAsync(CommonFolderQuery)

Parameter

Mengembalikan

Penerapan

Pengecualian

Lihat juga

Berlaku untuk

GetFoldersAsync(CommonFolderQuery, UInt32, UInt32)

Parameter

Mengembalikan

Penerapan

Pengecualian

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: