Skip to main content
IMap<K, V> interface

Applies to Windows and Windows Phone

Represents an associative collection.

.NET:  This interface appears as System.Collections.Generic.IDictionary<K,V>.


generic<typename K, typename V>
public interface class IMap : IIterable<IKeyValuePair>


[ Version(0x06020000)]

Type parameters


The type of the keys in the map.


The type of the values in the map.


The IMap interface inherits from IIterable(IKeyValuePair). IMap also has these types of members:


The IMap interface has these methods. It also inherits methods from the Object class.

Clear Removes all items from the map.
GetView Returns an immutable view of the map.
HasKey Determines whether the map contains the specified key.
Insert Inserts or replaces an item in the map.
Lookup Returns the item at the specified key in the map.
Remove Removes an item from the map.



The IMap interface has these properties.

PropertyAccess typeDescription


Read-onlyGets the number of items in the map.



When building Windows Store apps with the Microsoft .NET Framework, this interface is hidden and developers should use the System.Collections.Generic.IDictionary<K,V> interface.

The IMap<K,V> interface represents a collection of key-value pairs where a value can be accessed by its associated key. Properties and methods of IMap<K,V> support dictionary-type functionality, such as getting the size of the collection, and adding and removing items at specified locations in the collection. Additionally, the GetView method provides a snapshot of the map whose observable state does not change. The snapshot is useful when you need a view of the collection to refer to in subsequent operations that involve IMap<K,V>.

Interface inheritance

IMap inherits IIterable, using an IKeyValuePair constraint. Types that implement IMap also implement the interface members of IKeyValuePair, with an IKeyValuePair type constraint.


Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8





See also

Collections (C++/CX)