StorageFileQueryResult.FindStartIndexAsync(Object) Método

Definição

Namespace:

Windows.Storage.Search

Recupera o índice do arquivo dos resultados da consulta que mais correspondem ao valor da propriedade especificado (ou arquivo, se usado com FileActivatedEventArgs.NeighboringFilesQuery). A propriedade correspondente é determinada pela primeira SortEntry da lista 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)

Parâmetros

value

Object

Platform::Object

IInspectable

O valor da propriedade a ser correspondido ao pesquisar os resultados da consulta. A propriedade para que é usada para corresponder a esse valor é a propriedade na primeira SortEntry da lista QueryOptions.SortOrder .

Ou o arquivo a ser correspondido ao pesquisar com FileActivatedEventArgs.NeighboringFilesQuery.

Retornos

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

Quando esse método for concluído com êxito, ele retornará o índice do arquivo correspondente nos resultados da consulta ou o índice do arquivo em FileActivatedEventArgs.NeighboringFilesQuery. No último caso, espera-se que o arquivo seja originado de FileActivatedEventArgs.Files. Se essa função falhar, ela retornará uint. MaxValue.

Implementações

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

Atributos

RemoteAsyncAttribute

Exemplos

Este exemplo mostra como encontrar a primeira música em um álbum que tem um título começando com "R" em um conjunto de resultados de consulta que contém músicas agrupadas pelo título do álbum.

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");

Comentários

Você pode usar esse método em conjunto com FileActivatedEventArgs.NeighboringFilesQuery para iterar entre arquivos vizinhos, preservando a ordem de classificação da exibição original.