StorageFileQueryResult.FindStartIndexAsync(Object) Метод

Ссылка

Определение

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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Изменить

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

public:
 virtual IAsyncOperation<unsigned int> ^ FindStartIndexAsync(Platform::Object ^ value) = FindStartIndexAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<uint32_t> FindStartIndexAsync(IInspectable const& value);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<uint> FindStartIndexAsync(object value);

function findStartIndexAsync(value)

Public Function FindStartIndexAsync (value As Object) As IAsyncOperation(Of UInteger)

Параметры

value: Object
Platform::Object

IInspectable

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

Или файл, соответствующий при поиске с помощью FileActivatedEventArgs.NeighboringFilesQuery.

Возвращаемое значение

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

После успешного завершения этого метода он возвращает индекс соответствующего файла в результатах запроса или индекс файла в FileActivatedEventArgs.NeighboringFilesQuery. В последнем случае файл должен быть получен из fileActivatedEventArgs.Files. Если эта функция завершается сбоем, она возвращает uint. MaxValue.

Реализации

M:Windows.Storage.Search.IStorageQueryResultBase.FindStartIndexAsync(System.Object) M:Windows.Storage.Search.IStorageQueryResultBase.FindStartIndexAsync(Platform::Object) M:Windows.Storage.Search.IStorageQueryResultBase.FindStartIndexAsync(IInspectable)

Атрибуты: RemoteAsyncAttribute

Примеры

В этом примере показано, как найти первую песню в альбоме, название которого начинается с "R" в наборе результатов запроса, содержащего песни, сгруппированные по названию альбома.

QueryOptions queryOptions = new QueryOptions();
queryOptions.FolderDepth = FolderDepth.Deep;
queryOptions.IndexerOption = IndexerOption.OnlyUseIndexer;
SortEntry album = new SortEntry();
album.AscendingOrder = true;
album.PropertyName = "System.Music.AlbumTitle";
queryOptions.SortOrder.Add(album);

StorageFileQueryResult queryResult = musicFolder.CreateFileQueryWithOptions(queryOptions);
var firstIndex = await queryResult.FindStartIndexAsync("R");

Этот метод можно использовать в сочетании с FileActivatedEventArgs.NeighboringFilesQuery для итерации между соседними файлами с сохранением порядка сортировки исходного представления.

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

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