情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。
このトピックはまだ評価されていません - このトピックを評価する

StorageFolderQueryResult Class

クエリされる (storageFolderによって表される) フォルダーにある、フォルダー (またはファイル グループ) を一覧表示するクエリの結果にアクセスできるようにします。該当のフォルダー内のフォルダーまたはファイルのグループは、storageFolderQueryResult を使用すると列挙できます。

構文


var storageFolderQueryResult = storageFolder.createFolderQuery();

属性

[MarshalingBehavior(Agile)]
[Version(0x06020000)]

メンバー

StorageFolderQueryResultクラス には次の種類のメンバーがあります。

イベント

StorageFolderQueryResultクラス にはこれらのイベントがあります。

イベント説明
ContentsChanged Fires when a file is added to, deleted from, or modified in the folder being queried.
OptionsChanged Fires when the query options change.

 

メソッド

The StorageFolderQueryResult クラス には次のメソッドがあります。 With C#、Visual Basic、および C++ では、以下からもメソッドが継承されます。Object クラス.

メソッド説明
ApplyNewQueryOptions Modifies query results based on new QueryOptions.
FindStartIndexAsync Retrieves the index of the folder from the query results that most closely matches the specified property value. The property that is matched is determined by the first SortEntry of the QueryOptions.SortOrder list.
GetCurrentQueryOptions Retrieves the query options used to determine query results.
GetFoldersAsync() Retrieves a list of all the folders (or file groups) in the result set.
GetFoldersAsync(UInt32, UInt32) Retrieves folders (or file groups) in a specified range.
GetItemCountAsync Retrieves the number of folders (or file groups) in the set of query results.

 

プロパティ

StorageFolderQueryResultクラス には次のプロパティがあります。

プロパティアクセスの種類説明

Folder

読み取り専用Gets the folder originally used to create the StorageFolderQueryResult object.

 

解説

storageFolder または folderInformation オブジェクトから次のメソッドを呼び出して、storageFolderQueryResult オブジェクトを取得できます。

storageFolderQueryResult オブジェクトの使用方法を示すその他のコード例については、「Folder enumeration sample (フォルダー列挙体のサンプル)」を参照してください。

StorageFolderQueryResult オブジェクトを取得して、ある場所にフォルダーまたはファイル グループを列挙するには、その場所を表す storageFolder を取得し、フォルダー クエリを作成する必要があります。

Windows Phone 8

この API は実装されていません。呼び出された場合は、例外をスローします。「Windows Phone ランタイム API」を参照してください。

この例では、storageFolderQueryResult オブジェクトから一覧フォルダー (またはファイル グループ) を取得する方法を示します。



// Get the Pictures library, then rearrange it by month
var picturesLibrary = Windows.Storage.KnownFolders.picturesLibrary;

// Set query options to create groups of files within result
var queryOptions = new QueryOptions(Windows.Storage.Search.CommonFolderQuery.GroupByMonth);

// Create query and retrieve result
var queryResult = picturesLibrary.createFolderQuery(Windows.Storage.Search.CommonFolderQuery.groupByMonth);
queryResult.getFoldersAsync().done(function(folders) {
    // Process file groups (or folders)

    // Create an array of promises that will asynchronously
    // retrieve the files for each file group
    var promises = folders.map(function (folder) {
        return folder.getFilesAsync();
    });

    // Aggregate the results of multiple asynchronous operations
    // so that they are returned after all are completed. This
    // ensures that the groups are displayed in order.
    WinJS.Promise.join(promises).done(function (folderContents) {
        // Process the contents of each file group (or folder)

        for (var i in folderContents) {
            // Process the group/folder at index i of folderContents

            // Display the group name
            var group = outputResultGroup(folders.getAt(i).name);
            // Display the items in the group 
            outputItems(group, folderContents[i]);
        }
    });
});

queryResult の変数は storageFolderQueryResult を取得します。これはクエリの条件を満たすファイル グループ (またはフォルダー) を取得するために使用されます。

メモ  KnownFolders.PicturesLibrary を使用してライブラリにアクセスするには、写真ライブラリ機能が必要です。機能およびファイル アクセスの詳細については、「File access and permissions in file picker (ファイル ピッカーでのファイルのアクセスと許可)」を参照してください。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8 [実装されていません。"解説" を参照してください]

名前空間

Windows.Storage.Search
Windows::Storage::Search [C++]

メタデータ

Windows.winmd

参照

Windows.Storage.storageFolder.createFolderQuery methods
Windows.Storage.storageFolder.createFolderQueryWithOptions method
Windows.Storage.BulkAccess.folderInformation.createFolderQuery methods
Windows.Storage.BulkAccess.folderInformation.createFolderQueryWithOptions method

 

 

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft. All rights reserved.