Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

WeakEventManager.ListenerList Class

Provides a built-in collection list for storing listeners for a WeakEventManager.

Namespace:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
protected class ListenerList
You cannot use this class in XAML.

Although this list contains members that resemble those defined by IList and ICollection, and provide similar functionality, this class implements neither of those interfaces.

Most WeakEventManager derived classes do not need to use any members on WeakEventManager.ListenerList. The WeakEventManager methods ProtectedAddListener and ProtectedRemoveListener use a default WeakEventManager.ListenerList internally, one list for each source.

You only need to call WeakEventManager.ListenerList methods if your WeakEventManager class maintains multiple lists for the same event-source combination, with each list created to account for different conditions of the event. In this case, you would not use ProtectedAddListener and ProtectedRemoveListener and would instead implement AddListener or RemoveListener to act upon listeners in just one of the internal listener lists, typically based on a parameter that you add to AddListener or RemoveListener. Also, the handler implementation that receives the raw event cannot simply call DeliverEvent; you must instead keep track of the specifics of the event and deliver the event only to the appropriate list using DeliverEventToList.

The various methods of WeakEventManager.ListenerList are provided so that you can work with your internal lists and so that you can prevent modification of the list during actual delivery of the event.

An example class that used this implementation technique is PropertyChangedEventManager, which maintains separate listener lists for PropertyChanged based on which property changed.

System.Object
  System.Windows.WeakEventManager.ListenerList
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.