StorageFolder.CreateFileQuery Metode

Definisi

Ruang nama:

Windows.Storage

Overload

CreateFileQuery()	Mendapatkan objek hasil kueri yang berisi file di folder saat ini.
CreateFileQuery(CommonFileQuery)	Mendapatkan objek hasil kueri yang berisi 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 CommonFileQuery yang ditentukan.

CreateFileQuery()

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

public:
 virtual StorageFileQueryResult ^ CreateFileQuery() = CreateFileQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFileQueryOverloadDefault")]
StorageFileQueryResult CreateFileQuery();

[Windows.Foundation.Metadata.Overload("CreateFileQueryOverloadDefault")]
public StorageFileQueryResult CreateFileQuery();

function createFileQuery()

Public Function CreateFileQuery () As StorageFileQueryResult

Mengembalikan

StorageFileQueryResult

Objek hasil kueri. Panggil metode GetFilesAsync dari hasil kueri untuk mendapatkan daftar datar file. Metode ini mengembalikan daftar jenis IReadOnlyList<StorageFile>. Setiap file diwakili oleh item jenis StorageFile.

Penerapan

CreateFileQuery()

Atribut

OverloadAttribute

Contoh

Contoh berikut mendapatkan objek hasil kueri yang berisi file di folder saat ini dengan memanggil metode CreateFileQuery().

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

// Get the app's installation folder.
StorageFolder appFolder = Windows.ApplicationModel.Package.Current.InstalledLocation;

// Get the files in the current folder.
StorageFileQueryResult results = appFolder.CreateFileQuery();

// Iterate over the results and print the list of files
// to the Visual Studio Output window.
IReadOnlyList<StorageFile> filesInFolder = await results.GetFilesAsync();
foreach (StorageFile item in filesInFolder)
{
    Debug.WriteLine(item.Name);
}

IAsyncAction MainPage::ExampleCoroutineAsync()
{
    // Get the app's installation folder.
    Windows::Storage::StorageFolder appFolder{ Windows::ApplicationModel::Package::Current().InstalledLocation() };
    // Get the files in the current folder.
    Windows::Storage::Search::StorageFileQueryResult results{ appFolder.CreateFileQuery() };

    Windows::Foundation::Collections::IVectorView<Windows::Storage::StorageFile> filesInFolder{
        co_await results.GetFilesAsync() };

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

//Get the app's installation folder
StorageFolder^ appFolder = Windows::ApplicationModel::Package::Current->InstalledLocation;
//Get the files in the current folder
StorageFileQueryResult^ results = appFolder->CreateFileQuery();

create_task(results->GetFilesAsync()).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.

Anda juga bisa mendapatkan daftar file di folder saat ini secara asinkron dengan memanggil salah satu metode GetFilesAsync .

Untuk menentukan opsi kueri tambahan, panggil metode CreateFileQueryWithOptions .

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

Lihat juga

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

Mendapatkan objek hasil kueri yang berisi 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 CommonFileQuery yang ditentukan.

public:
 virtual StorageFileQueryResult ^ CreateFileQuery(CommonFileQuery query) = CreateFileQuery;

/// [Windows.Foundation.Metadata.Overload("CreateFileQuery")]
StorageFileQueryResult CreateFileQuery(CommonFileQuery const& query);

[Windows.Foundation.Metadata.Overload("CreateFileQuery")]
public StorageFileQueryResult CreateFileQuery(CommonFileQuery query);

function createFileQuery(query)

Public Function CreateFileQuery (query As CommonFileQuery) As StorageFileQueryResult

Parameter

query

CommonFileQuery

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

Mengembalikan

StorageFileQueryResult

Objek hasil kueri. Panggil metode GetFilesAsync dari hasil kueri untuk mendapatkan daftar datar file, diurutkan seperti yang ditentukan oleh kueri. Metode ini mengembalikan daftar jenis IReadOnlyList<StorageFile>. Setiap file diwakili oleh item jenis StorageFile.

Penerapan

CreateFileQuery(CommonFileQuery)

Atribut

OverloadAttribute

Pengecualian

ArgumentException

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

Keterangan

CommonFileQuery mengurutkan file berdasarkan atribut file tertentu (seperti judul atau tanggal) dengan cepat dan mudah.

Saat Anda menentukan opsi DefaultQuery dari enumerasi CommonFileQuery , kueri ini adalah kueri dangkal yang hanya mengembalikan file di folder saat ini. Saat Anda menentukan nilai lain dari enumerasi CommonFileQuery , kueri ini 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 daftar metode yang mengidentifikasi kueri dangkal dan kueri mendalam, lihat Keterangan dalam topik GetFilesAsync.

Untuk memeriksa apakah CommonFileQuery tertentu tersedia, panggil metode IsCommonFileQuerySupported folder.

Anda juga bisa mendapatkan daftar file di folder saat ini secara asinkron dengan memanggil salah satu metode GetFilesAsync .

Untuk Windows Server 2012 Anda harus menginstal komponen pengindeks untuk menggunakan beberapa nilai CommonFileQuery karena komponen pengindeks tidak diinstal secara default.

Lihat juga

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)