IVector<T> 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示項目的隨機存取集合。
。網 由於 .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
- 屬性
- 實作
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[]) |
從指定索引開始的向量擷取多個專案。
|
| GetView() |
傳回向量的不可變檢視。 |
| IndexOf(T, UInt32) |
擷取向量中指定專案的索引。 |
| InsertAt(UInt32, T) |
在向量中指定的索引處插入專案。 |
| RemoveAt(UInt32) |
拿掉向量中指定索引處的專案。 |
| RemoveAtEnd() |
從向量中移除最後一個專案。 |
| ReplaceAll(T[]) |
以指定的專案取代向量中的所有專案。 |
| SetAt(UInt32, T) |
設定向量中指定索引處的值。 |