IMapView<K,V> 介面

  • 參考

定義

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

表示地圖中的不可變檢視。

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

public interface class IMapView : IIterable<IKeyValuePair<K, V> ^>
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3833646656, 41784, 19162, 173, 207, 39, 34, 114, 228, 140, 185)]
template <typename K, typename V>
struct IMapView : IIterable<IKeyValuePair<K, V>>
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(3833646656, 41784, 19162, 173, 207, 39, 34, 114, 228, 140, 185)]
public interface IReadOnlyDictionary<K,V> : IEnumerable<KeyValuePair<K,V>>
Public Interface IReadOnlyDictionary(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.IReadOnlyDictionary<TKey，TValue> 介面來實作只讀對應/字典類型。 在任何 Windows 執行階段 類型已實作 IMapView<K、V> 的情況下，.NET 程式代碼都可以改用 IReadOnlyDictionary<TKey、TValue> 的 API。 這包括所有現有的 Windows 執行階段 API，以及使用原本從 C# 或 Visual Basic 應用程式中實作 Windows 執行階段 元件 API 等案例。

IMapView<K，V> 介面代表索引鍵/值組的集合，其中值可由其相關聯的索引鍵存取。 IMapView<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>，如果找到則保留值，如果找不到，則為沒有值。

介面繼承

IMapView 使用 IKeyValuePair 條件約束繼承 IIterable。 實作 IMapView 的類型也會使用 IKeyValuePair 類型條件約束來實作 IKeyValuePair 的介面成員。 同樣地，如果您使用 . NET，IEnumerable 支援;T>，其條件約束類型做為 KeyValuePair ，其使用與 IReadOnlyDictionary<TKey，TValue> 實作相同的索引鍵和實值類型。

屬性

Size

取得地圖中的項目數目。

方法

HasKey(K)

判斷地圖檢視檢視是否包含指定的索引鍵。
Lookup(K)

傳回地圖檢視檢視檢視中位於指定索引鍵的專案。
Split(IMapView<K,V>, IMapView<K,V>)

將地圖檢視檢視分割成兩個檢視。

適用於

另請參閱