Поделиться через


StorageFolderQueryResult Класс

Определение

Предоставляет доступ к результатам запроса, в котором перечислены папки (или группы файлов) в запрашиваемой папке (которая представлена storageFolder). Вы можете использовать StorageFolderQueryResult для перечисления папок или групп файлов в этой папке.

public ref class StorageFolderQueryResult sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFolderQueryResult final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFolderQueryResult
Public NotInheritable Class StorageFolderQueryResult
Наследование
Object Platform::Object IInspectable StorageFolderQueryResult
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В этом примере показано, как получить папки списка (или группы файлов) из объекта StorageFolderQueryResult.

// Get the Pictures library
Windows.Storage.StorageFolder picturesLibrary = Windows.Storage.KnownFolders.PicturesLibrary;

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

// Create query and retrieve result
StorageFolderQueryResult queryResult = picturesLibrary.CreateFolderQueryWithOptions(queryOptions);
IReadOnlyList<StorageFolder> folders = await queryResult.GetFoldersAsync();
// Process file groups
foreach (StorageFolder folder in folders)
{
    // Get and process files in group
    IReadOnlyList<StorageFile> fileList = await folder.GetFilesAsync();
    OutputPanel.Children.Add(CreateHeaderTextBlock(folder.Name + " (" + fileList.Count + ")"));
    foreach (StorageFile file in fileList)
    {
        // Process file
    }
}

Переменная queryResult получает объект StorageFolderQueryResult, используемый для получения файловых групп (или папок), соответствующих критериям запроса.

Примечание

Для доступа к библиотеке с помощью KnownFolders.PicturesLibrary требуется библиотека изображений. Дополнительные сведения о возможностях и доступе к файлам см. в разделе Разрешения на доступ к файлам.

Комментарии

Примечание

Хотя он не относится к marshalling_behavior(agile), этот класс можно рассматривать как гибкий. Дополнительные сведения см. в разделе Потоки и маршалинг (C++/CX)..

Объект StorageFolderQueryResult можно получить, вызвав следующие методы из объекта StorageFolder или FolderInformation :

Дополнительные примеры кода, демонстрирующие использование объектов storageFolderQueryResult, см. в примере перечисления Папок.

Чтобы получить объект StorageFolderQueryResult для перечисления папок или групп файлов в расположении, необходимо получить объект storageFolder , представляющий расположение, а затем создать запрос к папке.

Свойства

Folder

Возвращает папку, которая использовалась для создания объекта StorageFolderQueryResult . Эта папка представляет область запроса.

Методы

ApplyNewQueryOptions(QueryOptions)

Изменяет результаты запроса на основе новых queryOptions.

FindStartIndexAsync(Object)

Извлекает индекс папки из результатов запроса, которые наиболее точно соответствуют указанному значению свойства. Соответствующее свойство определяется первым свойством SortEntry списка QueryOptions.SortOrder .

GetCurrentQueryOptions()

Извлекает параметры запроса, используемые для определения результатов запроса.

GetFoldersAsync()

Извлекает список всех папок (или групп файлов) в результирующем наборе.

GetFoldersAsync(UInt32, UInt32)

Извлекает папки (или группы файлов) в указанном диапазоне.

GetItemCountAsync()

Извлекает количество папок (или групп файлов) в наборе результатов запроса.

События

ContentsChanged

Возникает, когда файл добавляется в папку, из которой выполняется запрос, удаляется из нее или изменяется из нее. Это событие возникает только после того , как метод GetFilesAsync был вызван хотя бы один раз.

OptionsChanged

Срабатывает при изменении параметров запроса.

Применяется к

См. также раздел