IMapView<K,V> Antarmuka

Referensi

Definisi

Ruang nama:: Windows.Foundation.Collections

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili tampilan yang tidak dapat diubah ke dalam peta.

.BERSIH Antarmuka ini muncul sebagai System.Collections.Generic.IReadOnlyDictionary<TKey,TValue> karena proyeksi bahasa .NET. Dalam hal apa pun di mana jenis Windows Runtime telah menerapkan kode IMapView<K,V>, .NET dapat menggunakan API IReadOnlyDictionary<TKey,TValue> sebagai gantinya.

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))

Jenis parameter

K

V

Atribut: ContractVersionAttribute GuidAttribute

Penerapan: IIterable<IKeyValuePair<K,V>> IEnumerable<KeyValuePair<K,V>>

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.FoundationContract (diperkenalkan dalam v1.0)

Keterangan

Saat pemrograman dengan .NET, antarmuka ini tersembunyi dan pengembang harus menggunakan antarmuka System.Collections.Generic.IReadOnlyDictionary<TKey,TValue> jika mereka ingin menerapkan jenis peta/kamus baca-saja. Dalam hal apa pun di mana jenis Windows Runtime telah menerapkan kode IMapView<K,V>, .NET dapat menggunakan API IReadOnlyDictionary<TKey,TValue> sebagai gantinya. Ini termasuk semua WINDOWS Runtime API yang ada dan juga skenario seperti menggunakan API komponen Windows Runtime yang awalnya diterapkan di C++ dari aplikasi C# atau Visual Basic.

Antarmuka IMapView<K,V> mewakili kumpulan pasangan kunci-nilai di mana nilai dapat diakses oleh kunci terkait. Properti dan metode IMapView<K,V> mendukung fungsionalitas jenis kamus, seperti mendapatkan ukuran koleksi, atau pencarian, tetapi tidak mendukung penambahan atau penghapusan item karena peta bersifat baca-saja.

Fungsi ekstensi C++/WinRT

Catatan

Fungsi ekstensi ada pada jenis proyeksi C++/WinRT untuk API Windows Runtime tertentu. Misalnya, winrt::Windows::Foundation::IAsyncAction adalah jenis proyeksi C++/WinRT untuk IAsyncAction. Fungsi ekstensi bukan bagian dari permukaan antarmuka biner aplikasi (ABI) dari jenis Windows Runtime yang sebenarnya, sehingga tidak terdaftar sebagai anggota API Windows Runtime. Tetapi Anda dapat memanggilnya dari dalam proyek C++/WinRT apa pun. Lihat fungsi C++/WinRT yang memperluas WINDOWS Runtime API.

auto begin() const;

Mengembalikan iterator ke pasangan kunci-nilai pertama koleksi, untuk digunakan dalam algoritma C++ seperti perulangan berbasis for rentang.

auto end() const;

Mengembalikan iterator ke satu melewati pasangan kunci-nilai terakhir dari koleksi, untuk digunakan dalam algoritma C++ seperti perulangan berbasis for rentang.

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

Mencoba mencari elemen di peta dengan kunci kunci. Untuk jenis referensi, mengembalikan nilai jika ditemukan, atau nullptr jika tidak ditemukan. Untuk jenis nilai, mengembalikan std::opsional<V>, yang menyimpan nilai jika ditemukan, atau tidak memiliki nilai jika tidak ditemukan.

Pewarisan antarmuka

IMapView mewarisi IIterable, menggunakan batasan IKeyValuePair . Jenis yang mengimplementasikan IMapView juga mengimplementasikan anggota antarmuka IKeyValuePair, dengan batasan jenis IKeyValuePair . Demikian pula, jika Anda menggunakan .NET, ada dukungan untuk IEnumerable; T>, dengan jenis batasannya sebagai KeyValuePair yang menggunakan jenis kunci dan nilai yang sama seperti halnya implementasi IReadOnlyDictionary<TKey,TValue> .

Properti

Size	Mendapatkan jumlah elemen di peta.

Metode

HasKey(K)	Menentukan apakah tampilan peta berisi kunci yang ditentukan.
Lookup(K)	Mengembalikan item pada kunci yang ditentukan dalam tampilan peta.
Split(IMapView<K,V>, IMapView<K,V>)	Membagi tampilan peta menjadi dua tampilan.

Berlaku untuk