StoreContext.GetUserCollectionWithPagingAsync Метод

Определение

Пространство имен:

Windows.Services.Store

Получает сведения Microsoft Store для надстроек текущего приложения, для которого пользователь приобрел. Этот метод поддерживает разбиение по страницам для возврата результатов.

public:
 virtual IAsyncOperation<StoreProductPagedQueryResult ^> ^ GetUserCollectionWithPagingAsync(IIterable<Platform::String ^> ^ productKinds, unsigned int maxItemsToRetrievePerPage) = GetUserCollectionWithPagingAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StoreProductPagedQueryResult> GetUserCollectionWithPagingAsync(IIterable<winrt::hstring> const& productKinds, uint32_t const& maxItemsToRetrievePerPage);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StoreProductPagedQueryResult> GetUserCollectionWithPagingAsync(IEnumerable<string> productKinds, uint maxItemsToRetrievePerPage);

function getUserCollectionWithPagingAsync(productKinds, maxItemsToRetrievePerPage)

Public Function GetUserCollectionWithPagingAsync (productKinds As IEnumerable(Of String), maxItemsToRetrievePerPage As UInteger) As IAsyncOperation(Of StoreProductPagedQueryResult)

Параметры

productKinds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Массив строк, указывающих типы надстроек, для которых требуется получить сведения. Список поддерживаемых строковых значений см. в описании свойства ProductKind.

maxItemsToRetrievePerPage

UInt32

unsigned int

uint32_t

Максимальное количество надстроек, возвращаемых на каждой странице результатов.

Возвращаемое значение

IAsyncOperation<StoreProductPagedQueryResult>

Асинхронная операция, которая при успешном завершении возвращает объект StoreProductPagedQueryResult , предоставляющий доступ к сведениям Microsoft Store для надстроек текущего приложения, для которых пользователь приобрел, и соответствующей информации об ошибке, а также к следующей странице результатов.

Атрибуты

RemoteAsyncAttribute

Комментарии

Этот метод аналогичен Методу GetUserCollectionAsync с той разницей, что позволяет использовать разбиение по страницам для получения надстроек. Дополнительные сведения об использовании GetUserCollectionAsync, включая пример кода, см. в статье Получение сведений о продукте для приложений и надстроек.

Используйте HasMoreResults объекта StoreProductPagedQueryResult, чтобы определить наличие дополнительных страниц результатов, и метод GetNextAsync для получения следующей страницы результатов.

Если текущий пользователь не вошел в Store, свойство ExtendedError возвращаемого значения StoreProductPagedQueryResult вернет код ошибки 0x80070525 (ERROR_NO_SUCH_USER).

Примечание

Всегда используйте HasMoreResults , чтобы определить, доступно ли больше страниц, даже если текущая страница данных содержит меньше элементов, чем maxItemsToRetrievePerPage. Чтобы обеспечить более быстрые результаты, служба может возвращать меньше элементов на странице, чем maxItemsToRetrievePerPage , даже если доступно больше страниц данных.