Freigeben über


IIterator<T>.GetMany(T[]) Methode

Definition

Ruft mehrere Elemente aus dem Iterator ab.

C++/WinRT Die richtige Syntax für die C++/WinRT-Sprachprojektion ist 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

Parameter

items
T[]

Ein Array, das die vom Iterator abgerufenen Elemente empfängt.

C++/WinRT Ein winrt::array_view , der die vom Iterator abgerufenen Elemente empfängt.

Gibt zurück

UInt32

unsigned int

uint32_t

Die Anzahl der abgerufenen Elemente. Dieser Wert kann kleiner als die Größe von Elementen sein, wenn das Ende des Iterators erreicht ist.

Hinweise

Der Iterator wird über die abgerufenen Elemente erweitert.

C++/WinRT Zusätzlich zum Übergeben eines winrt::array_view<T> können Sie jedes Objekt übergeben, das in ein winrt::array_view<T> konvertiert werden kann, wie in den folgenden Beispielen.

  • C++ std::array<T, N>
  • Array von T im C-Stil
  • C++ std::vector<T>
  • { zeiger, length }, wobei der Zeiger ein Zeiger auf einen Puffer von T-Objekten und die Länge die Anzahl der Einträge im Puffer ist.
  • { first, last }, wobei first und last einen Bereich von T-Objekten darstellen [first, last)

Wenn sich die zugrunde liegende Auflistung geändert hat, löst der Iterator möglicherweise eine Ausnahme aus.

.NET Framework Wenn sich die zugrunde liegende Auflistung geändert hat, löst der Iterator möglicherweise eine Ausnahme mit einem COMException HResult von 0x8000000C (E_CHANGED_STATE) aus.

C++/WinRT Wenn sich die zugrunde liegende Auflistung geändert hat, löst der Iterator möglicherweise eine Ausnahme aus hresult_changed_state .

C++/CX Wenn sich die zugrunde liegende Auflistung geändert hat, löst der Iterator möglicherweise eine Ausnahme aus ChangedStateException .

Gilt für:

Weitere Informationen