StorageFileQueryResult.FindStartIndexAsync(Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
- Atributos
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.