共用方式為


StorageFileQueryResult.FindStartIndexAsync(Object) 方法

定義

如果與 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)
屬性

範例

這個範例示範如何在一組查詢結果中,尋找一個標題開頭為 「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 在鄰近檔案之間逐一查看,同時保留原始檢視的排序次序。

適用於