IIterator<T>.GetMany(T[]) 方法

定义

命名空间:

Windows.Foundation.Collections

从迭代器检索多个项。

C++/WinRT 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

参数

items

T[]

一个数组，用于接收从迭代器检索到的项。

C++/WinRT一个 winrt：：array_view，用于接收从迭代器检索到的项。

返回

UInt32

unsigned int

uint32_t

检索到的项数。 如果到达迭代器的末尾，此值可能小于 项 的大小。

注解

迭代器先行于检索到的项。

C++/WinRT 除了传递 winrt：：array_view<T> 之外，还可以传递任何可转换为 winrt：：array_view<T> 的对象，例如这些示例。

• C++ std：：array<T、N>
• C 样式的 T 数组
• C++ std：：vector<T>
• { pointer， length }，其中 指针 是指向 T 对象的缓冲区的指针， length 是缓冲区中的条目数
• { first， last }，其中 first 和 last 表示 T 对象的范围 [first， last)

如果基础集合已更改，则迭代器可能会引发异常。

.NET Framework 如果基础集合已更改，迭代器可能会引发COMException异常，HResult 为 0x8000000C (E_CHANGED_STATE) 。

C++/WinRT 如果基础集合已更改，迭代器可能会引发 hresult_changed_state 异常。

C++/CX 如果基础集合已更改，迭代器可能会引发 ChangedStateException 异常。

另请参阅

• IIterator<T>