IMap<K,V> 介面

  • 參考

定義

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

表示關聯的集合，也稱為對應或字典。

。網 由於 .NET 語言投影，此介面會顯示為 System.Collections.Generic.IDictionary<TKey，TValue> 。 在任何 Windows 執行階段 類型已實作 IMap<K、V> 的情況下，.NET 程式代碼都可以改用 IDictionary<TKey、TValue> 的 API。

public interface class IMap : IIterable<IKeyValuePair<K, V> ^>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(1009329662, 34073, 17857, 170, 121, 25, 123, 103, 24, 193, 193)]
template <typename K, typename V>
struct IMap : IIterable<IKeyValuePair<K, V>>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(1009329662, 34073, 17857, 170, 121, 25, 123, 103, 24, 193, 193)]
public interface IDictionary<K,V> : IEnumerable<KeyValuePair<K,V>>
Public Interface IDictionary(Of K, V)
Implements IEnumerable(Of KeyValuePair(Of K, V))

類型參數

K
V
屬性
ContractVersionAttribute GuidAttribute
實作
IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>>

Windows 需求

裝置系列
Windows 10 (已於 10.0.10240.0 引進)
API contract
Windows.Foundation.FoundationContract (已於 v1.0 引進)

備註

使用 .NET 進行程序設計時，此介面會隱藏，如果開發人員想要實作對應/字典類型，則開發人員應該使用 System.Collections.Generic.IDictionary<TKey，TValue> 介面。 在任何 Windows 執行階段 類型已實作 IMap<K、V> 的情況下，.NET 程式代碼都可以改用 IDictionary<TKey、TValue> 的 API。 這包括所有現有的 Windows 執行階段 API，以及使用原本在 Visual C++ 元件延伸模組中實作 Windows 執行階段 元件 API 的案例， (C# 或 Visual Basic 應用程式中的 C++/CX) 。

IMap<K，V> 介面代表索引鍵/值組的集合，其中值可由其相關聯的索引鍵存取。 IMap<K、V> 的屬性和方法支援字典類型功能，例如取得集合的大小，以及在集合中指定的位置新增和移除專案。 此外， GetView 方法會提供地圖的快照集，其可觀察狀態不會變更。 當您需要集合的檢視，以在涉及 IMap<K、V> 的後續作業中參考時，快照集非常有用。

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 迴圈。

auto TryLookup(param_type<K> const& key) const;

嘗試使用索引 鍵查詢對應中的專案。 針對參考型別，如果找到，則 nullptr 傳回值，如果找不到則傳回 。 針對實值型別，會傳回 std：：optional<V>，如果找到則保留值，如果找不到則沒有值。

bool TryRemove(param_type<K> const& key) const;

如果有的話，移除對應中具有索引 鍵的專案。 如果找到並移除專案，則傳 true 回 。 如果找不到專案，則傳 false 回 。

介面繼承

IMap<K，V> 會使用使用相同的索引鍵和實值類型的 IKeyValuePair 條件約束來繼承 IIterable。 實作 IMap<K、V> 的類型也會實作 IIterable 的介面成員，且 IKeyValuePair 類型條件約束共用相同的索引鍵和值。 同樣地，如果您使用 .NET， 則支援 IEnumerabe<T>，其條件約束類型為 KeyValuePair ，其使用與 IDictionary<TKey，TValue 實作相同的索引鍵和實值> 類型。

屬性

Size

取得地圖中的項目數。

方法

Clear()

從地圖中移除所有專案。
GetView()

傳回地圖的不可變檢視。
HasKey(K)

判斷對應是否包含指定的索引鍵。
Insert(K, V)

插入或取代地圖中的專案。
Lookup(K)

傳回對應中指定索引鍵處的專案。
Remove(K)

從地圖中移除專案。

適用於

另請參閱