StoreContext.GetUserCollectionWithPagingAsync Método

Definición

Espacio de nombres:

Windows.Services.Store

Obtiene información de Microsoft Store para los complementos de la aplicación actual para la que el usuario ha comprado. Este método admite la paginación para devolver los 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>

Matriz de cadenas que especifican los tipos de complementos para los que desea recuperar información. Para obtener una lista de los valores de cadena compatibles, consulta la propiedad ProductKind.

maxItemsToRetrievePerPage

UInt32

unsigned int

uint32_t

Número máximo de complementos que se van a devolver en cada página de resultados.

Devoluciones

IAsyncOperation<StoreProductPagedQueryResult>

Una operación asincrónica que, al finalizar correctamente, devuelve un objeto StoreProductPagedQueryResult que proporciona acceso a la información de Microsoft Store para los complementos de la aplicación actual para la que el usuario ha comprado y la información de error pertinente, así como la siguiente página de resultados.

Atributos

RemoteAsyncAttribute

Comentarios

Este método es similar a GetUserCollectionAsync, con la diferencia de que permite usar la paginación para recuperar los complementos. Para obtener más información sobre el uso de GetUserCollectionAsync, incluido un ejemplo de código, consulta Obtener información del producto para aplicaciones y complementos.

Usa el HasMoreResults del objeto StoreProductPagedQueryResult para determinar si hay páginas de resultados adicionales y usa el método GetNextAsync para obtener la siguiente página de resultados.

Si el usuario actual no ha iniciado sesión en store, la propiedad ExtendedError del valor devuelto StoreProductPagedQueryResult devolverá el código de error 0x80070525 (ERROR_NO_SUCH_USER).

Nota

Use siempre HasMoreResults para determinar si hay más páginas disponibles, incluso si la página actual de datos contiene menos elementos que maxItemsToRetrievePerPage. Para proporcionar resultados más rápidos, el servicio puede devolver menos elementos en una página que maxItemsToRetrievePerPage aunque haya más páginas de datos disponibles.