IVector<T> 接口

定义

表示元素的随机访问集合。

.NET 由于 .NET 语言投影,此接口显示为 System.Collections.Generic.IList<T> 。 在Windows 运行时类型已实现 IVector<T> 的情况下,.NET 代码可以改用 IList<T> 的 API。

public interface class IVector : IIterable<T>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
template <typename T>
struct IVector : IIterable<T>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(2436052969, 4513, 17221, 163, 162, 78, 127, 149, 110, 34, 45)]
public interface IList<T> : IEnumerable<T>
Public Interface IList(Of T)
Implements IEnumerable(Of T)

类型参数

T
属性
实现

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 中引入)
API contract
Windows.Foundation.FoundationContract (在 v1.0 中引入)

注解

使用 .NET 编程时,此接口处于隐藏状态,如果开发人员想要实现向量/列表类型,开发人员应使用 System.Collections.Generic.IList<T> 接口。 在Windows 运行时类型已实现 IVector<T> 的情况下,.NET 代码可以改用 IList<T> 的 API。 这包括所有现有的Windows 运行时 API,以及使用最初在 Visual C++ 组件扩展中实现的 Windows 运行时 组件的 API, (C++/CX) C# 或 Visual Basic 应用。

IVector<T> 接口表示可由索引单独访问的指定类型的对象的集合。 IVector<T> 的属性和方法支持列表类型功能,例如获取集合的大小,以及在集合中的指定位置添加和删除项。 此外, GetView 方法提供矢量的快照,其可观测状态不会更改。 如果需要集合视图来引用涉及 IVector<T> 的后续操作,快照非常有用。

C++/WinRT 扩展函数

注意

某些Windows 运行时 API 的 C++/WinRT 投影类型上存在扩展函数。 例如, winrt::Windows::Foundation::IAsyncActionIAsyncAction 的 C++/WinRT 投影类型。 扩展函数不是应用程序二进制接口的一部分, (ABI) 实际Windows 运行时类型的图面,因此它们不会列为Windows 运行时 API 的成员。 但可以从任何 C++/WinRT 项目中调用它们。 请参阅扩展 Windows 运行时 API 的 C++/WinRT 函数

auto begin() const;

将迭代器返回到集合的第一个元素,以便在 C++ 算法(如基于 for 范围的循环)中使用。

auto end() const;

将迭代器返回到集合的最后一个元素之后的迭代器,以便在基于 for 范围的循环等 C++ 算法中使用。

接口继承

IVector 继承 IIterable。 实现 IVector 的类型还实现 IIterable 的接口成员。 同样,如果使用 .NET,则支持 IEnumerable<T>

属性

Size

获取向量中的项数。

方法

Append(T)

将项追加到向量末尾。

Clear()

从向量中删除所有项。

GetAt(UInt32)

返回向量中指定索引处的项。

GetMany(UInt32, T[])

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

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

GetView()

返回矢量的不可变视图。

IndexOf(T, UInt32)

检索向量中指定项的索引。

InsertAt(UInt32, T)

在向量中的指定索引处插入项。

RemoveAt(UInt32)

删除向量中指定索引处的项。

RemoveAtEnd()

从向量中删除最后一项。

ReplaceAll(T[])

将向量中的所有项替换为指定的项。

SetAt(UInt32, T)

设置向量中指定索引处的值。

适用于

另请参阅