StorageFileQueryResult.FindStartIndexAsync(Object) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera el índice del archivo de los resultados de la consulta que coinciden con el valor de propiedad especificado (o archivo, si se usa con FileActivatedEventArgs.NeighboringFilesQuery). La propiedad coincidente viene determinada por el primer SortEntry de la 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
Valor de propiedad que se va a buscar al buscar los resultados de la consulta. La propiedad a la que se usa para hacer coincidir este valor es la propiedad de la primera clase SortEntry de la lista QueryOptions.SortOrder .
O bien, el archivo que se va a buscar al buscar con FileActivatedEventArgs.NeighboringFilesQuery.
Devoluciones
Cuando este método se completa correctamente, devuelve el índice del archivo coincidente en los resultados de la consulta o el índice del archivo en FileActivatedEventArgs.NeighboringFilesQuery. En este último caso, se espera que el archivo sea de origen de FileActivatedEventArgs.Files. Si se produce un error en esta función, devuelve uint. MaxValue.
Implementaciones
- Atributos
Ejemplos
En este ejemplo se muestra cómo buscar la primera canción en un álbum que tiene un título que comienza con la "R" en un conjunto de resultados de consulta que contiene canciones agrupadas por título del á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");
Comentarios
Puede usar este método junto con FileActivatedEventArgs.NeighboringFilesQuery para iterar entre los archivos vecinos y conservar el criterio de ordenación de la vista original.