IMap<K,V> Antarmuka

Definisi

Ruang nama:

Windows.Foundation.Collections

Mewakili koleksi asosiatif, juga dikenal sebagai peta atau kamus.

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

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

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.IDictionary<TKey,TValue> jika mereka ingin mengimplementasikan jenis peta/kamus. Dalam hal apa pun di mana jenis Windows Runtime telah menerapkan kode IMap<K,V>, .NET dapat menggunakan API IDictionary<TKey,TValue> sebagai gantinya. Ini termasuk semua WINDOWS Runtime API yang ada dan juga skenario seperti menggunakan API komponen Windows Runtime yang awalnya diterapkan dalam ekstensi komponen Visual C++ (C++/CX) dari aplikasi C# atau Visual Basic.

Antarmuka IMap<K,V> mewakili kumpulan pasangan kunci-nilai di mana nilai dapat diakses oleh kunci terkait. Properti dan metode IMap<K,V> mendukung fungsionalitas jenis kamus, seperti mendapatkan ukuran koleksi, dan menambahkan dan menghapus item di lokasi tertentu dalam koleksi. Selain itu, metode GetView menyediakan rekam jepret peta yang statusnya dapat diamati tidak berubah. Rekam jepret berguna ketika Anda memerlukan tampilan koleksi untuk dirujuk dalam operasi berikutnya yang melibatkan IMap<K,V>.

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.

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

Menghapus elemen di peta dengan kunci kunci, jika ada. Mengembalikan true jika elemen ditemukan dan dihapus. Mengembalikan false jika elemen tidak ditemukan.

Pewarisan antarmuka

IMap<K,V> mewarisi IIterable, menggunakan batasan IKeyValuePair yang menggunakan jenis kunci dan nilai yang sama. Jenis yang mengimplementasikan IMap<K, V> juga mengimplementasikan anggota antarmuka IIterable, dengan batasan jenis IKeyValuePair yang berbagi kunci dan nilai yang sama. Demikian pula, jika Anda menggunakan .NET, ada dukungan untuk IEnumerabe<T>, dengan jenis batasannya sebagai KeyValuePair yang menggunakan jenis kunci dan nilai yang sama seperti halnya implementasi IDictionary<TKey,TValue> .

Properti

Size	Mendapatkan jumlah item dalam peta.

Metode

Clear()	Menghapus semua item dari peta.
GetView()	Mengembalikan tampilan peta yang tidak dapat diubah.
HasKey(K)	Menentukan apakah peta berisi kunci yang ditentukan.
Insert(K, V)	Menyisipkan atau mengganti item dalam peta.
Lookup(K)	Mengembalikan item pada kunci yang ditentukan dalam peta.
Remove(K)	Menghapus item dari peta.

Lihat juga

• Koleksi (C++/CX)
• System.Collections.Generic.IDictionary< TKey,TValue>