IVectorView<T>.GetMany(UInt32, T[]) 方法

定义

命名空间:

Windows.Foundation.Collections

从给定索引处开始的向量视图中检索多个项。

C++/WinRT C++/WinRT 语言投影的正确语法为 uint32_t GetMany(uint32_t startIndex, winrt::array_view<T> items);。

public:
 unsigned int GetMany(unsigned int startIndex, Platform::Array <T> ^ items);

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

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

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

参数

startIndex

UInt32

unsigned int

uint32_t

从零开始的索引。

items

T[]

一个数组，用于接收从矢量视图复制的项。

C++/WinRT 接收从矢量视图复制的项的 winrt：：array_view 。

返回

UInt32

unsigned int

uint32_t

检索到的项数。 如果到达矢量的末尾，此值可以小于 项 的大小。

注解

使用 .NET 编程时，此接口是隐藏的。 请改用 IList 接口。

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

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

如果起始索引大于集合的大小，视图将引发异常。

C++/WinRT 如果起始索引大于或等于集合的大小，视图将引发 hresult_out_of_bounds 异常。

C++/CX 如果起始索引大于或等于集合的大小，视图将引发 OutOfBoundsException 异常。

如果基础集合已更改，视图可能会引发异常。

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

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