StorageFileQueryResult.FindStartIndexAsync(Object) Metode

Referensi

Definisi

Ruang nama:: Windows.Storage.Search

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mengambil indeks file dari hasil kueri yang paling cocok dengan nilai properti yang ditentukan (atau file, jika digunakan dengan FileActivatedEventArgs.NeighboringFilesQuery). Properti yang cocok ditentukan oleh SortEntry pertama dari daftar 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)

Parameter

value: Object
Platform::Object

IInspectable

Nilai properti yang cocok saat mencari hasil kueri. Properti yang digunakan untuk mencocokkan nilai ini adalah properti di SortEntry pertama dari daftar QueryOptions.SortOrder .

Atau, file yang cocok saat mencari dengan FileActivatedEventArgs.NeighboringFilesQuery.

Mengembalikan

IAsyncOperation<UInt32>

Windows.Foundation.IAsyncOperation

IAsyncOperation<uint32_t>

Ketika metode ini berhasil diselesaikan, metode ini mengembalikan indeks file yang cocok dalam hasil kueri atau indeks file di FileActivatedEventArgs.NeighboringFilesQuery. Dalam kasus terakhir, file diharapkan bersumber dari FileActivatedEventArgs.Files. Jika fungsi ini gagal, fungsi akan mengembalikan uint. MaxValue.

Penerapan

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

Atribut: RemoteAsyncAttribute

Contoh

Contoh ini menunjukkan cara menemukan lagu pertama dalam album yang memiliki judul yang dimulai dengan "R" dalam serangkaian hasil kueri yang berisi lagu yang dikelompokkan menurut judul 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");

Keterangan

Anda dapat menggunakan metode ini bersama dengan FileActivatedEventArgs.NeighboringFilesQuery untuk melakukan iterasi antara file tetangga sambil mempertahankan urutan sortir tampilan asli.

Berlaku untuk

Bagikan melalui