IKeyValuePair<K,V> 介面
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
表示索引鍵/值組。 當您需要將兩個型別參數封裝成一個型別參數，以滿足另一個泛型介面的條件約束時，這通常用來作為條件約束類型。
。網 此介面會顯示為 System.Collections.Generic.KeyValuePair<TKey，TValue> (結構，而不是介面) 。 在任何 Windows 執行階段 類型已實作 IKeyValuePair<K、V> 的情況下，.NET 程式代碼都可以改用 KeyValuePair 的 API。
public interface class IKeyValuePair/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.FoundationContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(45422889, 49604, 19070, 137, 64, 3, 18, 181, 193, 133, 0)]
template <typename K, typename V>
struct IKeyValuePair[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.FoundationContract), 65536)]
[Windows.Foundation.Metadata.Guid(45422889, 49604, 19070, 137, 64, 3, 18, 181, 193, 133, 0)]
public interface KeyValuePair<K,V>Public Interface KeyValuePair(Of K, V)類型參數
- K
- V
- 屬性
Windows 需求
| 裝置系列 |
Windows 10 (已於 10.0.10240.0 引進)
|
| API contract |
Windows.Foundation.FoundationContract (已於 v1.0 引進)
|
備註
使用 .NET 進行程序設計時，此介面會隱藏，開發人員應該使用 System.Collections.Generic.KeyValuePair<TKey，TValue> 結構。 在 Windows 執行階段 類型已實作 IKeyValuePair<K、V> 的情況下，包括當介面繼承 IKeyValuePair<K、V> 或使用它作為內部條件約束時，.NET 程式代碼可以將它視為 .NET KeyValuePair。
索引鍵/值組會在繼承 IIterable<T> 時用於 IMap<K、V> 介面中。 IMap<K、V> 的實際實作是可反覆運算的，而反覆執行或呼叫 First/Current 會使用與 IMap<K、V 實作相同的條件約束，傳回 IKeyValuePair<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 函式。
operator==
比較兩個 KeyValuePair 對象，比較索引鍵和值，而不是比較介面。
結構化系結 (C++/WinRT)
IKeyValuePair<K、V> 支援結構化系結。 例如
auto&& [key, value] = kvp;
相當於，
auto key = kvp.Key();
auto value = kvp.Value();
結構化系結在範圍型 for 循環中特別方便，可讓您逐一查看地圖的索引鍵/值組。
winrt::Windows::Foundation::Collections::IMap<K, V> map;
for (auto&& [key, value] : map) { ... }
屬性
| Key |
取得索引鍵/值組的索引鍵。 |
| Value |
取得索引鍵/值組的值。 |