StoreContext.GetUserCollectionWithPagingAsync Método

Definição

Namespace:

Windows.Services.Store

Obtém informações da Microsoft Store para os complementos do aplicativo atual para o qual o usuário comprou. Esse método dá suporte à paginação para retornar os resultados.

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)

Parâmetros

productKinds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

Uma matriz de cadeias de caracteres que especifica os tipos de complementos para os quais você deseja recuperar informações. Para obter uma lista dos valores de sequência com suporte, consulte a propriedade ProductKind.

maxItemsToRetrievePerPage

UInt32

unsigned int

uint32_t

O número máximo de complementos a serem retornados em cada página de resultados.

Retornos

IAsyncOperation<StoreProductPagedQueryResult>

Uma operação assíncrona que, após a conclusão bem-sucedida, retorna um objeto StoreProductPagedQueryResult que fornece acesso às informações da Microsoft Store para os complementos do aplicativo atual para o qual o usuário comprou e informações de erro relevantes, bem como a próxima página de resultados.

Atributos

RemoteAsyncAttribute

Comentários

Esse método é semelhante a GetUserCollectionAsync, com a diferença que permite que você use paginação para recuperar os complementos. Para obter mais informações sobre como usar GetUserCollectionAsync, incluindo um exemplo de código, consulte Obter informações do produto para aplicativos e complementos.

Use o HasMoreResults do objeto StoreProductPagedQueryResult para determinar se há páginas adicionais de resultados e use o método GetNextAsync para obter a próxima página de resultados.

Se o usuário atual não estiver conectado à Store, a propriedade ExtendedError do valor retornado StoreProductPagedQueryResult retornará o código de erro 0x80070525 (ERROR_NO_SUCH_USER).

Observação

Sempre use HasMoreResults para determinar se há mais páginas disponíveis, mesmo que a página atual de dados contenha menos itens do que maxItemsToRetrievePerPage. Para fornecer resultados mais rápidos, o serviço pode retornar menos itens em uma página do que maxItemsToRetrievePerPage , mesmo que haja mais páginas de dados disponíveis.