StorageFolder.CreateFileQuery 方法

定義

命名空間:

Windows.Storage

多載

CreateFileQuery()	取得查詢結果物件，其中包含目前資料夾中的檔案。
CreateFileQuery(CommonFileQuery)	取得查詢結果物件，其中包含目前資料夾中的檔案。 當 查詢 引數的值不是 CommonFileQuery.DefaultQuery時，也會從目前資料夾的子資料夾中取得檔案。 檔案會根據指定的 CommonFileQuery排序。

CreateFileQuery()

取得查詢結果物件，其中包含目前資料夾中的檔案。

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

傳回

StorageFileQueryResult

查詢結果物件。 呼叫查詢結果的 GetFilesAsync 方法，以取得檔案的一般清單。 這個方法會傳回IReadOnlyList<StorageFile> 類型的清單。 每個檔案都是以 StorageFile類型的專案來表示。

實作

CreateFileQuery()

屬性

OverloadAttribute

範例

下列範例會藉由呼叫 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());
 }
});

備註

此查詢是淺層查詢，只會傳回目前資料夾中的檔案。 如需識別淺層查詢和深層查詢的方法清單，請參閱 GetFilesAsync主題中的。

您也可以呼叫其中一個 GetFilesAsync 方法，以非同步方式取得目前資料夾中的檔案清單。

若要指定其他查詢選項，請呼叫 CreateFileQueryWithOptions 方法。

若要取得檔案或資料夾的專案，請呼叫 CreateItemQuery 方法。

另請參閱

• CreateFileQuery(CommonFileQuery)
• CreateFileQueryWithOptions(QueryOptions)

CreateFileQuery(CommonFileQuery)

取得查詢結果物件，其中包含目前資料夾中的檔案。 當 查詢 引數的值不是 CommonFileQuery.DefaultQuery時，也會從目前資料夾的子資料夾中取得檔案。 檔案會根據指定的 CommonFileQuery排序。

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

參數

query

CommonFileQuery

其中一個列舉值，指定如何排序檔案，並判斷查詢是否為淺層或深層。

傳回

StorageFileQueryResult

查詢結果物件。 呼叫查詢結果的 GetFilesAsync 方法，以取得一般檔案清單，依 查詢所指定排序。 這個方法會傳回IReadOnlyList<StorageFile> 類型的清單。 每個檔案都是以 StorageFile類型的專案來表示。

實作

CreateFileQuery(CommonFileQuery)

屬性

OverloadAttribute

例外狀況

ArgumentException

您為 < 不是程式庫資料夾的資料夾指定 xref：Windows.Storage.Search.CommonFileQuery？text=CommonFileQuery 列舉以外的DefaultQuery> 值。 檢查 查詢的值。

備註

CommonFileQuery會根據特定檔案屬性來排序檔案， (例如標題或日期) 快速且輕鬆地排序。

當您從CommonFileQuery列舉指定DefaultQuery選項時，此查詢是只會傳回目前資料夾中檔案的淺層查詢。 當您從 CommonFileQuery 列舉指定另一個值時，此查詢是深層查詢，會從目前資料夾和其子資料夾傳回檔案的扁平化清單。

提示

CommonFileQuery列舉的某些值只能與文件庫資料夾搭配使用， (例如圖片庫) 或 Homegroup 資料夾。 除了 DefaultQuery 選項之外，您只能使用 OrderByName 和 OrderBySearchRank 選項搭配非程式庫資料夾的資料夾。

如需識別淺層查詢和深層查詢的方法清單，請參閱 GetFilesAsync主題中的。

若要檢查特定 CommonFileQuery 是否可用，請呼叫資料夾的 IsCommonFileQuerySupported 方法。

您也可以呼叫其中一個 GetFilesAsync 方法，以非同步方式取得目前資料夾中的檔案清單。

針對 Windows Server 2012 您必須安裝索引子元件，才能使用一些 CommonFileQuery 值，因為預設不會安裝索引子元件。

另請參閱

• CreateFileQuery()
• CreateFileQueryWithOptions(QueryOptions)