StorageFileQueryResult.FindStartIndexAsync(Object) Méthode

Référence

Définition

Espace de noms:: Windows.Storage.Search

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Récupère l’index du fichier à partir des résultats de la requête qui correspond le plus à la valeur de propriété spécifiée (ou fichier, s’il est utilisé avec FileActivatedEventArgs.NeighboringFilesQuery). La propriété qui est mise en correspondance est déterminée par le premier SortEntry de la liste 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)

Paramètres

value: Object
Platform::Object

IInspectable

Valeur de propriété à mettre en correspondance lors de la recherche dans les résultats de la requête. La propriété à qui est utilisé pour faire correspondre cette valeur est la propriété dans le premier SortEntry de la liste QueryOptions.SortOrder .

Ou, le fichier à correspondre lors de la recherche avec FileActivatedEventArgs.NeighboringFilesQuery.

Retours

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

Une fois cette méthode terminée, elle retourne l’index du fichier correspondant dans les résultats de la requête ou l’index du fichier dans fileActivatedEventArgs.NeighboringFilesQuery. Dans ce dernier cas, le fichier doit provenir de FileActivatedEventArgs.Files. Si cette fonction échoue, elle retourne uint. MaxValue.

Implémente

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

Attributs: RemoteAsyncAttribute

Exemples

Cet exemple montre comment rechercher la première chanson d’un album dont le titre commence par le « R » dans un ensemble de résultats de requête qui contient des chansons regroupées par titre d’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");

Remarques

Vous pouvez utiliser cette méthode conjointement avec FileActivatedEventArgs.NeighboringFilesQuery pour itérer entre les fichiers voisins tout en préservant l’ordre de tri de la vue d’origine.

S’applique à

Partager via