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

StorageFileQueryResult Класс

  • Ссылка

Определение

Пространство имен:
Windows.Storage.Search
Изменить

Предоставляет доступ к результатам запроса файлов в расположении, представленном объектом StorageFolder . Вы можете использовать StorageFileQueryResult для перечисления файлов в этом расположении StorageFolder .

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

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

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

Примеры

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

// Set query options with filter and sort order for results
List<string> fileTypeFilter = new List<string>();
fileTypeFilter.Add(".jpg");
fileTypeFilter.Add(".png");
fileTypeFilter.Add(".bmp");
fileTypeFilter.Add(".gif");
var queryOptions = new QueryOptions(CommonFileQuery.OrderByName, fileTypeFilter);

// Create query and retrieve files
var query = KnownFolders.PicturesLibrary.CreateFileQueryWithOptions(queryOptions);
IReadOnlyList<StorageFile> fileList = await query.GetFilesAsync();
// Process results
foreach (StorageFile file in fileList)
{
    // Process file
}

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

Примечание

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

Комментарии

Примечание

Хотя он не относится к marshalling_behavior(agile), этот класс можно рассматривать как гибкий.

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

Свойства

Folder

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

Методы

ApplyNewQueryOptions(QueryOptions)

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

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

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

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

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

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

Возвращает соответствующие свойства файла с соответствующими текстовыми диапазонами.

События

ContentsChanged

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

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

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

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