StorageFolder.GetFilesAsync 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

GetFilesAsync()	Mendapatkan file dalam folder saat ini.
GetFilesAsync(CommonFileQuery)	Mendapatkan file dalam folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan nilai yang ditentukan dari enumerasi CommonFileQuery .
GetFilesAsync(CommonFileQuery, UInt32, UInt32)	Mendapatkan rentang file berbasis indeks dari daftar semua file di folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan nilai yang ditentukan dari enumerasi CommonFileQuery .

GetFilesAsync()

Edit

Mendapatkan file dalam folder saat ini.

public:
 virtual IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync() = GetFilesAsync;

/// [Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultOptionsStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync();

[Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultOptionsStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync();

function getFilesAsync()

Public Function GetFilesAsync () As IAsyncOperation(Of IReadOnlyList(Of StorageFile))

Mengembalikan

IAsyncOperation<IVectorView<StorageFile>>

IAsyncOperation<IReadOnlyList<StorageFile>>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan daftar file di folder saat ini. Daftar ini berjenis IReadOnlyList<StorageFile>. Setiap file dalam daftar diwakili oleh objek StorageFile .

Penerapan

GetFilesAsync()

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 folder Gambar pengguna dan subfoldernya, diurutkan menurut tanggal, dengan memanggil metode kelebihan beban GetFilesAsync(CommonFileQuery, UInt32, UInt32). Contoh ini mengembalikan maksimum 20 file, dimulai dengan file pada indeks 0. Karena opsi CommonFileQuery.OrderByDate mengurutkan tanggal dalam urutan turun (yaitu, dari yang terbaru ke terlama), contoh ini mengembalikan 20 foto terbaru pengguna.

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 first 20 files in the current folder, sorted by date.
IReadOnlyList<StorageFile> sortedItems = await picturesFolder.GetFilesAsync(CommonFileQuery.OrderByDate,0,20);

// Iterate over the results and print the list of files
// to the Visual Studio Output window.
foreach (StorageFile file in sortedItems)
    Debug.WriteLine(file.Name + ", " + file.DateCreated);

#include <winrt/Windows.Storage.h>
#include <winrt/Windows.Storage.Search.h>
...
IAsyncAction ExampleCoroutineAsync()
{
    // Get the user's Pictures library.
    // Enable the Pictures Library capability in the app manifest file.
    Windows::Storage::StorageFolder picturesLibrary{ Windows::Storage::KnownFolders::PicturesLibrary() };

    // Get the first 20 sorted images in the library, sorted by date.
    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFile> filesInFolder{
        co_await picturesLibrary.GetFilesAsync(Windows::Storage::Search::CommonFileQuery::OrderByDate, 0, 20) };

    // Iterate over the results, and print the list of files to the Visual Studio output window.
    for (Windows::Storage::StorageFile const& fileInFolder : filesInFolder)
    {
        std::wstring output{ fileInFolder.Name() + L' ' };
        ::OutputDebugString(output.c_str());
    }
    ::OutputDebugString(L"\n");
}

// Get user's pictures library
StorageFolder^ picturesLibrary = KnownFolders::PicturesLibrary;

// Get the first 20 sorted images in the library
create_task(picturesLibrary->GetFilesAsync(CommonFileQuery::OrderByDate,0,20)).then([=](IVectorView<StorageFile^>^ filesInFolder) {
 //Iterate over the results and print the list of files
 // to the visual studio output window
 for (auto it = filesInFolder->First(); it->HasCurrent; it->MoveNext())
 {
  StorageFile^ file = it->Current;
  String^ output = file->Name + "\n";
  OutputDebugString(output->Begin());
 }
});

Keterangan

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

Tabel berikut mencantumkan metode kelas StorageFolder yang mendapatkan daftar file. Tabel mengidentifikasi kueri dangkal yang hanya mengembalikan file dari folder saat ini, dan kueri mendalam yang mengembalikan file dari folder saat ini dan dari subfoldernya.

Beberapa metode mengambil nilai dari enumerasi CommonFileQuery . Saat Anda menentukan opsi DefaultQuery dari enumerasi CommonFileQuery , kueri adalah kueri dangkal yang hanya mengembalikan file di folder saat ini. Saat Anda menentukan nilai lain dari enumerasi CommonFileQuery , kueri adalah kueri mendalam yang mengembalikan daftar file yang diratakan dari folder saat ini dan dari subfoldernya.

Tip

Beberapa nilai dari enumerasi CommonFileQuery hanya dapat digunakan dengan folder pustaka (seperti pustaka Gambar) atau folder Grup Rumah. Selain opsi DefaultQuery , Anda hanya dapat menggunakan opsi OrderByName dan OrderBySearchRank dengan folder yang bukan folder pustaka.

Untuk mendapatkan hasil kueri mendalam dari folder yang bukan folder pustaka, panggil metode CreateFileQueryWithOptions(QueryOptions) dan tentukan Deep sebagai nilai properti FolderDepth dari objek QueryOptions .

Metode	Membuat kueri dangkal yang hanya mengembalikan file dari folder saat ini	Membuat kueri mendalam yang mengembalikan file dari folder saat ini dan dari subfoldernya
GetFilesAsync()	Perilaku default metode ini.	T/A
GetFilesAsync(CommonFileQuery)	Tentukan opsi DefaultQuery .	Untuk folder pustaka, tentukan opsi selain DefaultQuery.
GetFilesAsync(CommonFileQuery, UInt32, UInt32)	Tentukan opsi DefaultQuery .	Untuk folder pustaka, tentukan opsi selain DefaultQuery.
CreateFileQuery()	Perilaku default metode ini.	T/A
CreateFileQuery(CommonFileQuery)	Tentukan opsi DefaultQuery .	Untuk folder pustaka, tentukan opsi selain DefaultQuery.
CreateFileQueryWithOptions(QueryOptions)	Perilaku default metode ini jika tidak ada opsi berikut yang ditentukan. - atau - Tentukan DefaultQuery sebagai nilai CommonFileQuery 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 CommonFileQuery saat Anda membuat instans objek QueryOptions . - atau - Untuk folder apa pun, tentukan Deep sebagai nilai properti FolderDepth dari QueryOptions.

Lihat juga

Berlaku untuk

GetFilesAsync(CommonFileQuery)

Edit

Mendapatkan file dalam folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan nilai yang ditentukan dari enumerasi CommonFileQuery .

public:
 virtual IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync(CommonFileQuery query) = GetFilesAsync;

/// [Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync(CommonFileQuery const& query);

[Windows.Foundation.Metadata.Overload("GetFilesAsyncOverloadDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync(CommonFileQuery query);

function getFilesAsync(query)

Public Function GetFilesAsync (query As CommonFileQuery) As IAsyncOperation(Of IReadOnlyList(Of StorageFile))

Parameter

query: CommonFileQuery

Salah satu nilai enumerasi yang menentukan cara mengurutkan file dan menentukan apakah kueri dangkal atau dalam.

Mengembalikan

IAsyncOperation<IVectorView<StorageFile>>

IAsyncOperation<IReadOnlyList<StorageFile>>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan daftar datar file, diurutkan seperti yang ditentukan oleh kueri. Daftar ini berjenis IReadOnlyList<StorageFile>. Setiap file dalam daftar diwakili oleh objek StorageFile .

Penerapan

GetFilesAsync(CommonFileQuery)

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

GetFilesAsync(CommonFileQuery, UInt32, UInt32)

Edit

Mendapatkan rentang file berbasis indeks dari daftar semua file di folder saat ini. Juga mendapatkan file dari subfolder folder saat ini ketika nilai argumen kueri adalah sesuatu selain CommonFileQuery.DefaultQuery. File diurutkan berdasarkan nilai yang ditentukan dari enumerasi CommonFileQuery .

public:
 virtual IAsyncOperation<IVectorView<StorageFile ^> ^> ^ GetFilesAsync(CommonFileQuery query, unsigned int startIndex, unsigned int maxItemsToRetrieve) = GetFilesAsync;

/// [Windows.Foundation.Metadata.Overload("GetFilesAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<StorageFile>> GetFilesAsync(CommonFileQuery const& query, uint32_t const& startIndex, uint32_t const& maxItemsToRetrieve);

[Windows.Foundation.Metadata.Overload("GetFilesAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<StorageFile>> GetFilesAsync(CommonFileQuery query, uint startIndex, uint maxItemsToRetrieve);

function getFilesAsync(query, startIndex, maxItemsToRetrieve)

Public Function GetFilesAsync (query As CommonFileQuery, startIndex As UInteger, maxItemsToRetrieve As UInteger) As IAsyncOperation(Of IReadOnlyList(Of StorageFile))

Parameter

query: CommonFileQuery

Salah satu nilai enumerasi yang menentukan cara mengurutkan file dan menentukan apakah kueri dangkal atau dalam.

startIndex: UInt32
unsigned int

uint32_t

Indeks berbasis nol dari file pertama dalam rentang yang akan diambil.

maxItemsToRetrieve: UInt32
unsigned int

uint32_t

Jumlah maksimum file yang akan diambil.

Mengembalikan

IAsyncOperation<IVectorView<StorageFile>>

IAsyncOperation<IReadOnlyList<StorageFile>>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan daftar datar file yang diurutkan seperti yang ditentukan oleh kueri. Daftar ini berjenis IReadOnlyList<StorageFile>. Setiap file dalam daftar diwakili oleh objek StorageFile .

Penerapan

M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFilesAsync(Windows.Storage.Search.CommonFileQuery,System.UInt32,System.UInt32) M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFilesAsync(Windows.Storage.Search.CommonFileQuery,unsigned int,unsigned int) M:Windows.Storage.Search.IStorageFolderQueryOperations.GetFilesAsync(Windows.Storage.Search.CommonFileQuery,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

StorageFolder.GetFilesAsync Metode

Definisi

Overload

GetFilesAsync()

Mengembalikan

Penerapan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

GetFilesAsync(CommonFileQuery)

Parameter

Mengembalikan

Penerapan

Pengecualian

Lihat juga

Berlaku untuk

GetFilesAsync(CommonFileQuery, UInt32, UInt32)

Parameter

Mengembalikan

Penerapan

Pengecualian

Lihat juga

Berlaku untuk

Saran dan Komentar

Saran dan Komentar

Sumber Daya Tambahan: