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 アプリから C++ で最初に実装された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 プロジェクト内から呼び出すことができます。 API を拡張する C++/WinRT 関数Windows ランタイム参照してください。

auto begin() const;

範囲ベース for のループなどの C++ アルゴリズムで使用するために、コレクションの最初のキーと値のペアを指す反復子を返します。

auto end() const;

範囲ベース for のループなどの C++ アルゴリズムで使用するために、コレクションの最後のキーと値のペアの 1 つ後ろの反復子を返します。

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

キー キーを使用してマップ内の要素の検索を試 みます。 参照型の場合は、 が見つかった場合、または nullptr 見つからない場合は 値を返します。 値型の場合、 は std::optional<V を返します。この V> は、見つかった場合は値を保持し、見つからない場合は値を持たない。

インターフェイスの継承

IMapView は IKeyValuePair 制約を使用して IIterable を継承します。 IMapView を実装する型は、 IKeyValuePair 型制約を使用して、 IKeyValuePair のインターフェイス メンバーも実装します。 同様に、.NET を使用している場合は、IEnumerable のサポートがあります。制約型が KeyValuePair である T>。IReadOnlyDictionary<TKey,TValue 実装と同じキーと値の型を>使用します。

プロパティ

Size	マップ内の要素の数を取得します。

メソッド

HasKey(K)	マップ ビューに指定したキーが含まれているかどうかを判断します。
Lookup(K)	マップ ビューの指定したキーにある項目を返します。
Split(IMapView<K,V>, IMapView<K,V>)	マップ ビューを 2 つのビューに分割します。

こちらもご覧ください

• IReadOnlyDictionary<TKey,TValue>
• コレクション (C++/CX)