ContentLinkProviderCollection.GetMany(UInt32, ContentLinkProvider[]) Método

Definição

Namespace:

Windows.UI.Xaml.Documents

Recupera vários elementos em uma única passagem pelo iterador.

public:
 virtual unsigned int GetMany(unsigned int startIndex, Platform::Array <ContentLinkProvider ^> ^ items) = IVector<ContentLinkProvider ^>::GetMany;

uint32_t GetMany(uint32_t const& startIndex, winrt::array_view <ContentLinkProvider const&> & items);

public uint GetMany(uint startIndex, ContentLinkProvider[] items);

function getMany(startIndex, items)

Public Function GetMany (startIndex As UInteger, items As ContentLinkProvider()) As UInteger

Parâmetros

startIndex

UInt32

unsigned int

uint32_t

O índice do qual iniciar a recuperação.

items

ContentLinkProvider[]

Fornece o destino do resultado. Dimensione o tamanho inicial da matriz como uma "capacidade" para especificar quantos resultados devem ser recuperados.

Retornos

UInt32

unsigned int

uint32_t

O número de itens recuperados.

Implementações

M:Windows.Foundation.Collections.IVector1.GetMany(System.UInt32,0[]) M:Windows.Foundation.Collections.IVector1.GetMany(unsigned int,0[]) M:Windows.Foundation.Collections.IVector1.GetMany(uint32_t,0[])

Comentários

Importante

Essa API dá suporte a links de conteúdo. Os recursos do Windows que habilitam links de conteúdo não estão disponíveis em versões do Windows posteriores ao Windows 10 versão 1903. Os links de conteúdo para controles de texto XAML não funcionarão nas versões do Windows posteriores à 1903.

O método GetMany opera de forma idêntica como se estivesse chamando e para cada elemento na matriz fornecida. Isso significa que o primeiro elemento retornado pelo método GetMany é o mesmo elemento retornado recuperando a propriedade antes de chamar GetMany. Depois que a chamada GetMany retornar, a propriedade recuperará o elemento após o último elemento retornado pela chamada GetMany ou produzirá um erro se não houver mais elementos nas sequências.

O método GetMany retorna o número real de elementos retornados. Deve ser o mínimo de a) o número de elementos restantes na coleção ou b) o número de elementos solicitados, que é "capacidade". Portanto, sempre que GetMany retorna menos do que o número de elementos solicitados, o final da sequência é atingido. Ele retorna o número de elementos recuperados no parâmetro de saída "real".

Quando o chamador especifica uma capacidade de zero, a posição do iterador é inalterada. Os elementos na matriz após os valores retornados não são alterados.