Enhanced C#
Loyc library documentation
 All Classes Namespaces Functions Variables Enumerations Enumerator Properties Events Pages
Events | List of all members
Loyc.Collections.INotifyListChanging< T, TCollection > Interface Template Reference

Encapsulates the ListChanging event that notifies listeners of dynamic changes to a collection, such as when items are about to be added and removed or the whole list is about to be refreshed. More...

Source file:
Inheritance diagram for Loyc.Collections.INotifyListChanging< T, TCollection >:
Loyc.Collections.ICollectionExWithChangeEvents< T > Loyc.Collections.ICollectionWithChangeEvents< T > Loyc.Collections.IDictionaryWithChangeEvents< K, V > Loyc.Collections.INotifyListChanging< T > Loyc.Collections.Impl.CollectionWithChangeEvents< T, TColl > Loyc.Collections.IDictionaryExWithChangeEvents< K, V > Loyc.Collections.Impl.DictionaryWithChangeEvents< K, V, TDictionary > Loyc.Collections.AListBase< K, T > Loyc.Collections.AListBase< K, T > Loyc.Collections.IListWithChangeEvents< T > Loyc.Collections.CollectionWithChangeEvents< T > Loyc.Collections.DictionaryWithChangeEvents< K, V > Loyc.Collections.AListBase< K, T >.Enumerator Loyc.Collections.AListBase< K, T >.ObserverMgr Loyc.Collections.AListBase< T > Loyc.Collections.BDictionary< K, V > Loyc.Collections.BList< T > Loyc.Collections.AListBase< K, T >.Enumerator Loyc.Collections.AListBase< K, T >.ObserverMgr Loyc.Collections.AListBase< T > Loyc.Collections.BDictionary< K, V > Loyc.Collections.BList< T > Loyc.Collections.IListExWithChangeEvents< T >

Remarks

Encapsulates the ListChanging event that notifies listeners of dynamic changes to a collection, such as when items are about to be added and removed or the whole list is about to be refreshed.

Template Parameters
TType of items in the list
TCollectionType of the first argument of the event

This approach to change notification is more lightweight than the standard INotifyCollectionChanged interface because that interface sends both a list of new items and a list of old items, so many changes require a pair of temporary objects to be created that hold the two lists of items.

In contrast, the ListChanging event includes only one list that specifies the set of new items. In the case of Remove events, no change list is included. Since the collection has not been modified yet, the user handling the event can examine the list to learn which item(s) are being removed; if the list is being changed, it can similarly examine the list to see the old set of items.

An optimization is available when only a single item is being added or changed. In that case, the collection class should create a lightweight read-only single-item list by calling ListExt.Single{T}(T). Such a list has less overhead than List{T} and the same overhead as an array of one item.

Events

ListChangingHandler< T,
TCollection > 		ListChanging
 Occurs when the collection associated with this interface is about to change. More...
 

Event Documentation

ListChangingHandler<T, TCollection> Loyc.Collections.INotifyListChanging< T, TCollection >.ListChanging

Occurs when the collection associated with this interface is about to change.

The event handler receives a ListChangeInfo{T} argument, which describes the change.

The event handler is not allowed to modify the list that is changing while it is handling the event, but it can read the list.

IMPORTANT: if the event handler throws an exception, the change does not actually happen. Collections that support this event must ensure that the collection is not left in an invalid state in the event that a ListChanging event handler throws an exception. When throwing an exception, be aware that this can cause other event handlers attached to the same event not to receive any change notification.

Generated on Mon Jul 27 2026 06:54:03 for Enhanced C# by   doxygen 1.8.7