StorageFileQueryResult.FindStartIndexAsync(Object) Methode

Referenz

Definition

Namespace:: Windows.Storage.Search

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ruft den Index der Datei aus den Abfrageergebnissen ab, die am ehesten mit dem angegebenen Eigenschaftswert (oder der Datei, bei Verwendung mit FileActivatedEventArgs.NeighboringFilesQuery) übereinstimmen. Die übereinstimmenden Eigenschaften werden durch den ersten SortEntry der Liste QueryOptions.SortOrder bestimmt.

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)

Parameter

value: Object
Platform::Object

IInspectable

Der Eigenschaftswert, der beim Durchsuchen der Abfrageergebnisse übereinstimmen soll. Die -Eigenschaft zu, die verwendet wird, um diesen Wert abzugleichen, ist die -Eigenschaft im ersten SortEntry der Liste QueryOptions.SortOrder .

Oder die Datei, die bei der Suche mit FileActivatedEventArgs.NeighboringFilesQuery abgeglichen werden soll.

Gibt zurück

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

Wenn diese Methode erfolgreich abgeschlossen wurde, wird der Index der übereinstimmenden Datei in den Abfrageergebnissen oder der Index der Datei in FileActivatedEventArgs.NeighboringFilesQuery zurückgegeben. Im letzteren Fall wird erwartet, dass die Datei aus FileActivatedEventArgs.Files stammt. Wenn diese Funktion fehlschlägt, wird uint zurückgegeben. MaxValue.

Implementiert

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

Attribute: RemoteAsyncAttribute

Beispiele

In diesem Beispiel wird gezeigt, wie Sie den ersten Song in einem Album mit einem Titel finden, der mit "R" beginnt, in einer Reihe von Abfrageergebnissen, die Nach Albumtiteln gruppiert sind.

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

Hinweise

Sie können diese Methode in Verbindung mit FileActivatedEventArgs.NeighboringFilesQuery verwenden, um zwischen benachbarten Dateien zu durchlaufen, während die Sortierreihenfolge der ursprünglichen Ansicht beibehalten wird.

Gilt für:

Freigeben über