共用方式為

StorageItemQueryResult.GetItemsAsync 方法

  • 參考

定義

命名空間:
Windows.Storage.Search

多載

GetItemsAsync()

擷取查詢結果集中所有專案 (檔案和資料夾的清單) 。
GetItemsAsync(UInt32, UInt32)

擷取指定範圍內 (檔案和資料夾) 的專案清單。

GetItemsAsync()

編輯

擷取查詢結果集中所有專案 (檔案和資料夾的清單) 。

public:
 virtual IAsyncOperation<IVectorView<IStorageItem ^> ^> ^ GetItemsAsync() = GetItemsAsync;
/// [Windows.Foundation.Metadata.Overload("GetItemsAsyncDefaultStartAndCount")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<IStorageItem>> GetItemsAsync();
[Windows.Foundation.Metadata.Overload("GetItemsAsyncDefaultStartAndCount")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<IStorageItem>> GetItemsAsync();
function getItemsAsync()
Public Function GetItemsAsync () As IAsyncOperation(Of IReadOnlyList(Of IStorageItem))

傳回

IAsyncOperation<IVectorView<IStorageItem>>

IAsyncOperation<IReadOnlyList<IStorageItem>>

當此方法順利完成時，它會傳回專案類型 IVectorView) (清單。 每個專案都是 IStorageItem 類型，代表檔案、資料夾或檔案群組。

在此清單中，檔案會以 StorageFile 物件表示，而資料夾或檔案群組則以 StorageFolder 物件表示。

屬性
OverloadAttribute RemoteAsyncAttribute

另請參閱

適用於

GetItemsAsync(UInt32, UInt32)

編輯

擷取指定範圍內 (檔案和資料夾) 的專案清單。

public:
 virtual IAsyncOperation<IVectorView<IStorageItem ^> ^> ^ GetItemsAsync(unsigned int startIndex, unsigned int maxNumberOfItems) = GetItemsAsync;
/// [Windows.Foundation.Metadata.Overload("GetItemsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<IStorageItem>> GetItemsAsync(uint32_t const& startIndex, uint32_t const& maxNumberOfItems);
[Windows.Foundation.Metadata.Overload("GetItemsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<IStorageItem>> GetItemsAsync(uint startIndex, uint maxNumberOfItems);
function getItemsAsync(startIndex, maxNumberOfItems)
Public Function GetItemsAsync (startIndex As UInteger, maxNumberOfItems As UInteger) As IAsyncOperation(Of IReadOnlyList(Of IStorageItem))

參數

startIndex
UInt32

unsigned int

uint32_t

要擷取之第一個專案之以零起始的索引。 這個參數的預設值是 0。

maxNumberOfItems
UInt32

unsigned int

uint32_t

要擷取的專案數目上限。 使用 -1 來擷取所有專案。 如果範圍包含的專案少於最大數目，則會傳回範圍中的所有專案。

傳回

IAsyncOperation<IVectorView<IStorageItem>>

IAsyncOperation<IReadOnlyList<IStorageItem>>

當此方法順利完成時，它會傳回專案類型 IVectorView) (清單。 每個專案都是 IStorageItem 類型，代表檔案、資料夾或檔案群組。

在此清單中，檔案會以 StorageFile 物件表示，而資料夾或檔案群組則以 StorageFolder 物件表示。

屬性
OverloadAttribute RemoteAsyncAttribute

備註

您可以在這兩種類型的儲存物件上使用 IsOfType 方法，以瞭解專案是 StorageFile 或 StorageFolder 物件。

針對 C#/C++/VB：知道專案是 StorageFile 或 StorageFolder之後，您就可以將專案轉換成適當的類型，以便存取該物件特有的屬性和方法。

使用此多載，藉由呈現只包含必要資料夾子集之查詢結果的虛擬化檢視，以改善系統效能。 例如，如果您的應用程式在資源庫中顯示許多專案，您可以使用此範圍只擷取使用者目前可見的專案。

另請參閱

適用於