IVector<T> 介面

  • 參考

定義

命名空間:
Windows.Foundation.Collections
編輯

表示項目的隨機存取集合。

。網 由於 .NET 語言投影，此介面會顯示為 System.Collections.Generic.IList<T> 的 .NET 程式代碼。 在任何 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
屬性
ContractVersionAttribute GuidAttribute
實作
IIterable<T> IEnumerable<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：：IAsyncAction 是 IAsyncAction 的 C++/WinRT 投影類型。 擴充函式不是應用程式二進位介面的一部分， (實際 Windows 執行階段 類型的 ABI) 介面，因此它們不會列為 Windows 執行階段 API 的成員。 但您可以從任何 C++/WinRT 專案內呼叫它們。 請參閱擴充 Windows 執行階段 API 的 C++/WinRT 函式。

auto begin() const;

將反覆運算器傳回集合的第一個專案，以用於 C++ 演算法，例如範圍型 for 迴圈。

auto end() const;

將反覆運算器傳回至集合的最後一個元素之後的反覆運算器，以用於 C++ 演算法，例如範圍型 for 迴圈。

介面繼承

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)

設定向量中指定索引處的值。

適用於

另請參閱