WeakEventManager

The WeakEventManager class in the Scotec.Events.WeakEvents namespace provides a thread-safe mechanism for managing event subscriptions using weak references. This helps prevent memory leaks that can occur when event handlers are strongly referenced, especially in scenarios where publishers outlive their subscribers.

Purpose

In .NET, traditional event subscriptions create strong references between the event source and the event handler. If the subscriber is not explicitly unsubscribed, the event source will keep the subscriber alive, potentially causing memory leaks. WeakEventManager solves this by storing event handlers as weak references, allowing the garbage collector to reclaim subscribers when they are no longer in use.

Features

• Add weak event handlers for any event on any object.
• Remove weak event handlers manually or automatically when the target is collected.
• Automatic cleanup of dead handlers.
• Thread-safe management of event handler delegates.
• Disposable remover for easy unsubscription.
• Static API for global weak event management.

Usage

1. Adding a Weak Event Handler (Instance)

Subscribe to an event using a weak reference:

var manager = new WeakEventManager(); 
IDisposable remover = manager.AddWeakHandler<MySource, MyEventArgs>( sourceObject, "MyEvent", (src, args) => { /* handle event */ } );

• sourceObject: The object that publishes the event.
• "MyEvent": The name of the event to subscribe to.
• Handler: A lambda or method matching (src, args).

2. Removing a Weak Event Handler

You can remove a handler using the returned IDisposable:

remover.Dispose();

Or, remove it directly:

manager.RemoveWeakHandler<MySource, MyEventArgs>( sourceObject, "MyEvent", handler );

3. Cleaning Up Dead Handlers

To remove handlers whose targets have been garbage collected:

manager.Cleanup();

This can be useful to call periodically, for example, in an event or similar global pause event, to ensure that any unused handlers are removed, and memory can be reclaimed.