Gemstone Common Library
Event
Safely invokes event propagation with custom exception handler, continuing even if an attached user handler throws an exception.
Definition
Namespace: Gemstone.EventHandlerExtensions
Assembly: Gemstone.Common (in Gemstone.Common.dll) Version: 1.0.128 -- Release Build+d050cfc5563c89a1188cc3c6b2d417530856f490
Assembly: Gemstone.Common (in Gemstone.Common.dll) Version: 1.0.128 -- Release Build+d050cfc5563c89a1188cc3c6b2d417530856f490
C#
public static void SafeInvoke<TEventHandler, TEventArgs>(
this TEventHandler eventHandler,
Object? eventLock,
Action<Exception>? exceptionHandler,
Object? sender,
TEventArgs args,
bool parallel = false
)
where TEventHandler : MulticastDelegate
where TEventArgs : EventArgs
VB
<ExtensionAttribute>
Public Shared Sub SafeInvoke(Of TEventHandler As MulticastDelegate, TEventArgs As EventArgs) (
eventHandler As TEventHandler,
eventLock As Object,
exceptionHandler As Action(Of Exception),
sender As Object,
args As TEventArgs,
Optional parallel As Boolean = false
)C++
public:
[ExtensionAttribute]
generic<typename TEventHandler, typename TEventArgs>
where TEventHandler : MulticastDelegate
where TEventArgs : EventArgs
static void SafeInvoke(
TEventHandler eventHandler,
Object^ eventLock,
Action<Exception^>^ exceptionHandler,
Object^ sender,
TEventArgs args,
bool parallel = false
)JavaScript
Parameters
- eventHandler TEventHandler
- Source EventHandler to safely invoke.
- eventLock Object
- Locking object for accessing event handler invocation list; when set to null, lock will be on eventHandler.
- exceptionHandler ActionException
- Custom delegate to handle encountered exceptions; when set to null, exception will be suppressed, see SuppressedException.
- sender Object
- Event source.
- args TEventArgs
- Event arguments.
- parallel Boolean (Optional)
- Call event handlers in parallel, when attached handlers are greater than one.
Type Parameters
- TEventHandler
- MulticastDelegate type commonly derived from EventHandler.
- TEventArgs
- Type derived from EventArgs.