Partager via


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

Définition

Récupère plusieurs éléments à partir de l’itérateur.

C++/WinRT La syntaxe correcte pour la projection de langage C++/WinRT est 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

Paramètres

items
T[]

Tableau qui reçoit les éléments récupérés à partir de l’itérateur.

C++/WinRTWinrt::array_view qui reçoit les éléments récupérés à partir de l’itérateur.

Retours

UInt32

unsigned int

uint32_t

Nombre d’éléments récupérés. Cette valeur peut être inférieure à la taille des éléments si la fin de l’itérateur est atteinte.

Remarques

L’itérateur est avancé au-delà des éléments qui ont été récupérés.

C++/WinRT En plus de passer un winrt::array_view<T>, vous pouvez passer n’importe quel objet convertible vers un winrt::array_view<T>, comme ces exemples.

  • C++ std::array<T, N>
  • Tableau de style C de T
  • C++ std::vector<T>
  • { pointeur, length }, où pointeur est un pointeur vers une mémoire tampon d’objets T et longueur est le nombre d’entrées dans la mémoire tampon
  • { first, last }, où premier et dernier représentent une plage d’objets T [first, last)

Si la collection sous-jacente a changé, l’itérateur peut lever une exception.

.NET Framework Si la collection sous-jacente a changé, l’itérateur peut lever une COMException exception avec un résultat HResult de 0x8000000C (E_CHANGED_STATE).

C++/WinRT Si la collection sous-jacente a changé, l’itérateur peut lever une hresult_changed_state exception.

C++/CX Si la collection sous-jacente a changé, l’itérateur peut lever une ChangedStateException exception.

S’applique à

Voir aussi