StorageFileQueryResult.FindStartIndexAsync(Object) Metodo

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage.Search

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

Recupera l'indice del file dai risultati della query che corrispondono più strettamente al valore della proprietà specificato (o al file, se usato con FileActivatedEventArgs.NeighboringFilesQuery). La proprietà corrispondente è determinata dal primo SortEntry dell'elenco 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)

Parametri

value: Object
Platform::Object

IInspectable

Valore della proprietà da corrispondere durante la ricerca dei risultati della query. La proprietà utilizzata per corrispondere a questo valore è la proprietà nella prima proprietà SortEntry dell'elenco QueryOptions.SortOrder .

In alternativa, il file da trovare durante la ricerca con FileActivatedEventArgs.NeighboringFilesQuery.

Restituisce

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

Al termine di questo metodo, restituisce l'indice del file corrispondente nei risultati della query o nell'indice del file in FileActivatedEventArgs.NeighboringFilesQuery. In quest'ultimo caso, il file deve essere origine da FileActivatedEventArgs.Files. Se questa funzione ha esito negativo, restituisce uint. MaxValue.

Implementazioni

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

Attributi: RemoteAsyncAttribute

Esempio

In questo esempio viene illustrato come trovare la prima canzone in un album che ha un titolo che inizia con "R" in un set di risultati di query che contiene canzoni raggruppate per titolo dell'album.

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

Commenti

È possibile usare questo metodo insieme a FileActivatedEventArgs.NeighboringFilesQuery per eseguire l'iterazione tra i file adiacenti mantenendo l'ordine di ordinamento della vista originale.

Si applica a

Condividi tramite