I​Observable​Map<​K, ​V> I​Observable​Map<​K, ​V> I​Observable​Map<​K, ​V> Interface

Definition

Notifies listeners of dynamic changes to a map, such as when items are added or removed.

public : interface IObservableMap<K, V>public interface IObservableMap<K, V>Public Interface IObservableMap<K, V>
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.FoundationContract (introduced v1)

Remarks

The IObservableMap; interface enables clients to register for notification events to IMap; collections. For example, you might use IObservableMap; when you need to keep two map structures synchronized. In this case, use the IObservableMap; interface to receive notification of changes, so that the associated data structure can be updated.

Observable collections are mainly useful for XAML data binding scenarios. For more info, see Data binding in depth.

Interface inheritance

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

.NET usage

IObservableMap; isn't hidden for .NET usage. However, it's more common to use the .NET ObservableCollection<T> type (using a KeyValuePair as T) as a base class, or implement a Dictionary type or interface (generic or nongeneric) and INotifyCollectionChanged separately. If you do use IObservableMap; for .NET code, the base interfaces (and their members) project as System.Collections.Generic.IDictionary<TKey,TValue> and IEnumerable<T> (with KeyValuePair).

Events

MapChanged MapChanged MapChanged

Occurs when the map changes.

public : abstract event MapChangedEventHandler MapChangedpublic abstract event MapChangedEventHandler MapChangedPublic MustInherit Event MapChanged
Attributes

Remarks

The event handler receives an IMapChangedEventArgs; object that contains data that describes the event.

.NET usage

IObservableMap; isn't hidden for .NET usage. However, it's more common to use the .NET ObservableCollection<T> type (using a KeyValuePair as T) as a base class, or implement a Dictionary type or interface (generic or nongeneric) and INotifyCollectionChanged separately. If you do use IObservableMap; for .NET code, the base interfaces (and their members) project as System.Collections.Generic.IDictionary<TKey,TValue> and IEnumerable<T> (with KeyValuePair). MapChanged is the only API that's shared between the projections.

See Also

See Also