StorageFileQueryResult.FindStartIndexAsync(Object) 方法

定義

命名空間:

Windows.Storage.Search

如果與 FileActivatedEventArgs.NeighboringFilesQuery) 搭配使用，則從最符合指定屬性值 (或檔案的查詢結果擷取檔案的索引。 相符的屬性是由QueryOptions.SortOrder清單的第一個SortEntry所決定。

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)

參數

value

Object

Platform::Object

IInspectable

搜尋查詢結果時所要比對的屬性值。 用來比對此值的屬性是QueryOptions.SortOrder清單之第一個SortEntry中的 屬性。

或者，使用 FileActivatedEventArgs.NeighboringFilesQuery搜尋時要比對的檔案。

傳回

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

當此方法成功完成時，它會傳回查詢結果中相符檔案的索引，或 FileActivatedEventArgs.NeighboringFilesQuery中檔案的索引。 在後者的情況下，檔案應該來自 FileActivatedEventArgs.Files。 如果此函式失敗，則會傳回 uint。MaxValue。

實作

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

屬性

RemoteAsyncAttribute

範例

這個範例示範如何在一組查詢結果中，尋找一個標題開頭為 「R」 的相簿中的第一首歌曲，其中包含依相簿標題分組的歌曲。

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

備註

您可以使用這個方法搭配 FileActivatedEventArgs.NeighboringFilesQuery 在鄰近檔案之間逐一查看，同時保留原始檢視的排序次序。