Windows.Foundation.Collections Ruang nama

Referensi

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

Mendefinisikan objek koleksi standar, khusus, dan generik. Ini termasuk antarmuka generik IIterable<T>, IVector<T>, dan IMap<K, V>, yang digunakan sebagai pola untuk dukungan pengumpulan dasar di seluruh Windows Runtime API.

Kelas

PropertySet	Mewakili kumpulan properti, yang merupakan sekumpulan objek PropertyValue dengan kunci string.
StringMap	Koleksi asosiatif, juga dikenal sebagai peta atau kamus.
ValueSet	Mengimplementasikan peta dengan kunci jenis String dan nilai jenis Objek. Objek harus berupa PropertyValue atau ValueSet WinRT. Sebagai PropertyValue, itu bisa menjadi jenis apa pun kecuali PropertyTypeInspectableArray. Batasan ini ada untuk memastikan bahwa nilai dapat diserialisasikan; diteruskan oleh nilai di seluruh batas proses. Catatan Beberapa anggota hanya tersedia untuk bahasa yang ditentukan.

Antarmuka

IIterable<T>	Mengekspos iterator yang mendukung perulangan sederhana atas kumpulan jenis tertentu. .BERSIH Antarmuka ini muncul sebagai System.Collections.Generic.IEnumerable<T>. Dalam kasus apa pun di mana jenis Windows Runtime telah menerapkan IIterable<T>, kode .NET dapat menggunakan API IEnumerable<T> sebagai gantinya. Kode C# dapat menggunakan foreach, kode Visual Basic dapat menggunakan Untuk Setiap... Selanjutnya. Semua metode ekstensi .NET yang didasarkan pada IEnumerable<T> dan disertakan dalam .NET untuk aplikasi UWP dapat diakses (termasuk ekstensi System.Linq , selama Anda telah menyertakan namespace).
IIterator<T>	Mendukung iterasi sederhana melalui koleksi.
IKeyValuePair<K,V>	Mewakili pasangan kunci-nilai. Ini biasanya digunakan sebagai jenis batasan ketika Anda perlu merangkum dua parameter jenis menjadi satu untuk memenuhi batasan antarmuka generik lainnya. .BERSIH Antarmuka ini muncul sebagai System.Collections.Generic.KeyValuePair<TKey,TValue> (struktur, bukan antarmuka). Dalam kasus apa pun di mana jenis Windows Runtime telah menerapkan kode IKeyValuePair<K,V>, .NET dapat menggunakan API KeyValuePair sebagai gantinya.
IMap<K,V>	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.
IMapChangedEventArgs<K>	Menyediakan data untuk peristiwa pengumpulan peta yang diubah.
IMapView<K,V>	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.
IObservableMap<K,V>	Memberi tahu pendengar tentang perubahan dinamis pada peta, seperti kapan item ditambahkan atau dihapus.
IObservableVector<T>	Memberi tahu pendengar tentang perubahan pada vektor.
IPropertySet	Mewakili kumpulan pasangan kunci-nilai, yang menghubungkan beberapa antarmuka koleksi lainnya.
IVector<T>	Mewakili kumpulan elemen akses acak. .BERSIH Antarmuka ini tampaknya kode .NET sebagai System.Collections.Generic.IList<T> karena proyeksi bahasa .NET. Dalam kasus apa pun di mana jenis Windows Runtime telah menerapkan IVector<T>, kode .NET dapat menggunakan API IList<T> sebagai gantinya.
IVectorChangedEventArgs	Menyediakan data untuk peristiwa vektor yang diubah.
IVectorView<T>	Mewakili tampilan yang tidak dapat diubah ke dalam vektor. .BERSIH Antarmuka ini tampaknya kode .NET sebagai System.Collections.Generic.IReadOnlyList<T> karena proyeksi bahasa .NET. Dalam kasus apa pun di mana jenis Windows Runtime telah menerapkan IVectorView<T>, kode .NET dapat menggunakan API IReadOnlyList<T> sebagai gantinya.

Enum

CollectionChange

Menjelaskan tindakan yang menyebabkan perubahan pada koleksi.

Delegasikan

MapChangedEventHandler<K,V>	Mewakili metode yang menangani peristiwa yang diubah dari peta yang dapat diamati.
VectorChangedEventHandler<T>	Mewakili metode yang menangani peristiwa yang diubah dari vektor yang dapat diamati.

Keterangan

Banyak antarmuka dan objek yang ditentukan dalam namespace layanan ini memiliki bahasa yang berbeda yang setara tergantung pada bahasa pemrograman yang Anda gunakan. Untuk informasi selengkapnya tentang menggunakan antarmuka ini dari kode C++, lihat Koleksi (C++/CX). Untuk informasi selengkapnya tentang menggunakan jenis koleksi dari kode .NET, lihat Keterangan dalam jenis tertentu yang ditentukan di namespace ini.