Compartilhar via


IIterator<T>.GetMany(T[]) Método

Definição

Recupera vários itens do iterador.

C++/WinRT A sintaxe correta para a projeção da linguagem C++/WinRT é uint32_t GetMany(winrt::array_view<T> items);.

public:
 unsigned int GetMany(Platform::Array <T> ^ items);
uint32_t GetMany(winrt::array_view <T> & items);
public uint GetMany(T[] items);
Public Function GetMany (items As T()) As UInteger

Parâmetros

items
T[]

Uma matriz que recebe os itens recuperados do iterador.

C++/WinRT Um winrt::array_view que recebe os itens recuperados do iterador.

Retornos

UInt32

unsigned int

uint32_t

O número de itens que foram recuperados. Esse valor poderá ser menor que o tamanho dos itens se o final do iterador for atingido.

Comentários

O iterador é avançado após os itens que foram recuperados.

C++/WinRT Além de passar um winrt::array_view<T>, você pode passar qualquer objeto conversível para um winrt::array_view<T>, como estes exemplos.

  • C++ std::array<T, N>
  • Matriz de estilo C de T
  • C++ std::vector<T>
  • { pointer, length }, em que pointer é um ponteiro para um buffer de objetos T e length é o número de entradas no buffer
  • { first, last }, where first and last represent a range of T objects [first, last)

Se a coleção subjacente tiver sido alterada, o iterador poderá gerar uma exceção.

.NET Framework Se a coleção subjacente tiver sido alterada, o iterador poderá gerar uma COMException exceção com um HResult de 0x8000000C (E_CHANGED_STATE).

C++/WinRT Se a coleção subjacente tiver sido alterada, o iterador poderá gerar uma hresult_changed_state exceção.

C++/CX Se a coleção subjacente tiver sido alterada, o iterador poderá gerar uma ChangedStateException exceção.

Aplica-se a

Confira também