AdvancedHandler<THandler, TArgs> Class

Generic handler class

Inheritance Hierarchy

System.Object
  CMS.Base.AbstractHandler
    CMS.Base.AbstractAdvancedHandler
      CMS.Base.AdvancedHandler<THandler, TArgs>
        More...

Namespace: CMS.Base
Assembly: CMS.Base (in CMS.Base.dll) Version: 9.0.0

Syntax

public abstract class AdvancedHandler<THandler, TArgs> : AbstractAdvancedHandler
where THandler : new(), AdvancedHandler<THandler, TArgs>
where TArgs : new(), CMSEventArgs

Type Parameters

THandler

TArgs

The AdvancedHandler<THandler, TArgs> type exposes the following members.

Constructors

	Name	Description
Protected method	AdvancedHandler<THandler, TArgs>

Properties

	Name	Description
Public property	Allow	If true, the event is allowed to be raised
Public property	ControlRecursion	If true, the recursion control is enabled on this handler. (Inherited from AbstractHandler.)
Public property	Debug	If true, the handler is included in debug (Inherited from AbstractHandler.)
Public property	EventArguments	Handler arguments
Public property	IsBound	Returns true if the handler has some events bound
Public property	IsStatic	True, if the handler is a static handler (Inherited from AbstractHandler.)
Protected property	LogItem	Handlers log item of this handler
Public property	Name	Event name. The name serves for debug purposes and to uniquely identify the handler. (Inherited from AbstractHandler.)
Public property	OneTime	If true, this event can be executed only once. If the event was already executed, and new handler is added, it executes immediately. (Inherited from AbstractHandler.)
Public property	Parent	Parent handler
Public property	WasExecuted	Returns true if the event was already executed (Inherited from AbstractHandler.)
Protected property	WasFinished	Flag indicating whether the event was finished or not

Methods

	Name	Description
Public method	AddAfter	Adds the conditional after handler
Public method	AddBefore	Adds the conditional before handler
Protected method	AddEvent<THandler>	Adds the event to the list (Inherited from AbstractHandler.)
Public method	AddFailure	Adds the conditional after handler
Protected method	AssignCurrentHandler	Assigns the current handler to the event arguments (Inherited from AbstractHandler.)
Public method	Clear	Clears all bound event handlers from the event and resets the number of executions of the event (Overrides AbstractHandler.Clear().)
Protected method	CountExecution	Counts the execution of the event (Inherited from AbstractHandler.)
Public method	Dispose	Disposes the object (Overrides AbstractHandler.Dispose().)
Protected method	CheckBase	Checks if the handler is base handler instance, and fires an exception if not (Inherited from AbstractHandler.)
Protected method	CheckContinue	Checks whether the action can continue and if not, fires an exception.
Protected method	CheckEvent	Checks if the handler is event handler instance, and fires an exception if not (Inherited from AbstractHandler.)
Protected method	Raise<TArgs>	Raises the list of events (Inherited from AbstractHandler.)
Protected method	RaiseAfter	Raises the after event
Protected method	RaiseBefore	Raises the before event
Protected method	RaiseFailure	Raises the failure event
Protected method	RemoveEvent<THandler>	Removes the event from the list (Inherited from AbstractHandler.)
Public method	Reset	Resets the number of executions of the event (Inherited from AbstractHandler.)
Public method	SetParent	Sets the parent event of the event (Overrides AbstractHandler.SetParent(AbstractHandler).)
Public method	StartEvent()	Initiates the new handler context
Public method	StartEvent(EventArgs)	Initiates the new handler context
Public method	StartEvent(TArgs, Boolean)	Initiates the new handler context

Extension Methods

	Name	Description
Public Extension Method	CanContinue	Checks whether the context of execution should continue. (Defined by HandlersExtensions.)
Public Extension Method	DontSupportCancel	Disables the ability to cancel continuation of the execution context. (Defined by HandlersExtensions.)
Public Extension Method	FinishEvent	Finishes the event and raises the After event actions. (Defined by HandlersExtensions.)

Events

	Name	Description
Public event	After	Raised after the event occurs
Public event	Before	Raised before the event occurs
Public event	Failure	Raised in case the event handler didn't properly call finalization