Is this really the version you are looking for? Kentico 8 documentation is no longer updated. Use the switch in the header to choose your Kentico version.

Reference - Global system events

Event categories (classes):

ObjectEvents

Namespace: CMS.DataEngine

Contains events that occur for all types of objects in the system. See also: Handling object events

Important

Use the following classes to access the object events in the API:

  • ObjectEvents - events triggered for all object types
  • <name>Info.TYPEINFO.Events - events triggered only for a specific object type, for example: UserInfo.TYPEINFO.Events

Event

Event types

Handler parameters

Description

Insert
_______________________

Before
After
Failure

ObjectEventArgs

  Properties
  • Object (BaseInfo)

Occurs when a new object is created.

Update

Before
After
Failure

ObjectEventArgs

  Properties
  • Object (BaseInfo)

Occurs when the data of an existing object is updated.

Delete

Before
After
Failure

ObjectEventArgs

  Properties
  • Object (BaseInfo)

Occurs when an object is deleted.

GetContent

Execute
___________

ObjectEventArgs

  Properties
  • Content (string)

  • Object (BaseInfo)

Occurs before the system writes an object's data into smart search indexes (when building or updating indexes).

Allows you to determine exactly how search indexes store object content.

LogChange

Before
After
Failure

LogObjectChangeEventArgs

  Properties
  • Settings (LogObjectChangeSettings)
    _______________________________

Occurs when the system logs object changes for the purposes of staging and integration. For example, allows you to exclude specific objects from staging.

See also: Excluding content from staging and integration

CheckPermissions

Before
After
Failure

ObjectSecurityEventArgs

  Properties
  • Object (BaseInfo)

  • Permission (PermissionsEnum)

  • User (UserInfo)

  • SiteName (string)

  • Result (AuthorizationResultEnum)
    ________________________________

Occurs when the system checks permissions for objects of the given type.
Sort

Before
After
Failure

 ObjectSortEventArgs

  Properties
  • InfoObject (BaseInfo)

  • Ascending (bool)

  • OrderColumn (string)

  • NameColumn (string)_______________________________

Occurs when sorting of objects is requested.
ChangeOrder Before
After
Failure

ObjectChangeOrderEventArgs

  Properties
  • InfoObject (BaseInfo)

  • NewOrder (int)

  • RelativeOrder (int)

  • OrderColumn (string)_______________________________

 Occurs when a change in the order of objects is requested.

> Back to list of event categories

DocumentEvents

Namespace: CMS.DocumentEngine

Contains events fired when changes are made to documents.

Note:

Pages under workflow require a different approach to event handling. Use the events from the WorkflowEvents class instead of DocumentEvents.

For example, to handle the 'update' action for a page under workflow, use the SaveVersion event from WorkflowEvents instead of the DocumentEvents.Update event.

Event

Event types

Handler parameters

Description

Insert
_______________________

Before
After
Failure

DocumentEventArgs

  Properties
  • TargetParentNodeID (int)

  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a new document is created.

InsertNewCulture

Before
After
Failure

DocumentEventArgs

  Properties
  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a new culture version is created for a document.

InsertLink

Before
After
Failure

DocumentEventArgs

  Properties
  • TargetParentNodeID (int)
  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when creating new linked documents.

Update

Before
After
Failure

DocumentEventArgs

  Properties
  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when an existing document is updated.

Move

Before
After
Failure

DocumentEventArgs

  Properties
  • TargetParentNodeID (int)
  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a document is moved to a different position in the site's content tree.

Copy

Before
After
Failure

DocumentEventArgs

  Properties
  • TargetParentNodeID (int)
  • IncludeChildren (bool)
  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a new copy of a document is created.

Delete

Before
After
Failure

DocumentEventArgs

  Properties
  • Node (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a document is deleted.

GetContent

Execute
___________

DocumentSearchEventArgs

  Properties
  • Content (string)
  • Node (TreeNode)

  • Settings (SearchIndexSettingsInfo)
  • IndexInfo (ISearchIndexInfo)
  • SearchDocument (ISearchDocument)
  • IsCrawler (bool)

Occurs before the system writes a document's data into a Smart search index (when building or updating indexes).

Allows you to determine exactly how search indexes store document content.

LogChange

Before
After
Failure

LogDocumentChangeEventArgs

  Properties
  • Settings (LogDocumentChangeSettings)
    __________________________________

Occurs when the system logs document changes for the purposes of staging and integration. For example, allows you to exclude specific documents from staging.

See also: Excluding content from staging and integration

CheckPermissions

Before
After
Failure

DocumentSecurityEventArgs

  Properties
  • Node (TreeNode)

  • Permission (PermissionsEnum)

  • User (UserInfo)

  • SiteName (string)

  • Result (AuthorizationResultEnum)
    _____________________________

Occurs when the system checks permissions for documents.
Sort Before
After
Failure

DocumentSortEventArgs

  Properties
  • ParentNodeId (int)

  • Ascending (bool)
  • SortType (DocumentSortEnum) ________A_________________
Occurs when sorting of documents is requested.
ChangeOrder Before
After
Failure

DocumentChangeOrderEventArgs

  Properties
  • Node (TreeNode)

  • OrderType (DocumentOrderEnum)_________________________

  Properties
  • Node (TreeNode)

  • NewOrder (int)

  • RelativeOrder (bool)____________________________

Occurs when a change in the order of documents is requested.

Document attachments

SaveAttachment

Before
After
Failure

DocumentEventArgs

  Properties
  • Attachment (AttachmentInfo)
  • Node (TreeNode)

  • TreeProvider (TreeProvider)
    __________________________

Occurs when a file attachment is added to a document or updated.

DeleteAttachment

Before
After
Failure

DocumentEventArgs

  Properties
  • Attachment (AttachmentInfo)
  • Node (TreeNode)

  • TreeProvider (TreeProvider)
    __________________________

Occurs when a file attachment is removed from a document.

Document security

AuthorizeDocument

Execute

DocumentAuthorizationEventArgs

  Properties
  • User (UserInfo)

  • Data (DataSet)

  • Document (TreeNode)

  • PermissionName (string)

  • AuthorizationResult (AuthorizationResultEnum)
    _______________________________________

Occurs when the system performs a security check for the permissions of specific documents.

FilterDataSetByPermissions

Execute

DocumentAuthorizationEventArgs

  Properties
  • User (UserInfo)

  • Data (DataSet)

  • Document (TreeNode)

  • PermissionName (string)

  • AuthorizationResult (AuthorizationResultEnum)
    _______________________________________

Occurs when the system filters a set of documents according to the document permissions of a user.

> Back to list of event categories

WorkflowEvents

Namespace: CMS.DocumentEngine

Contains events related to workflow and versioning actions.

Event

Event types

Handler parameters

Description

Approve
_______________________

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • PreviousStep (WorkflowStepInfo) - only in the After event

  • TreeProvider (TreeProvider)
    _________________________________________________

Occurs when a document is approved to the next step.

Reject

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • PreviousStep (WorkflowStepInfo) - only in the After event

  • TreeProvider (TreeProvider)
    _________________________________________________

Occurs when a document is rejected back to a previous step

Publish

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • PublishedDocument(TreeNode) - only in the After event

  • PreviousStep (WorkflowStepInfo) - only in the After event

  • TreeProvider (TreeProvider)
    _________________________________________________

Occurs when a document reaches the published step.

Archive

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • PreviousStep (WorkflowStepInfo) - only in the After event

  • TreeProvider (TreeProvider)
    _________________________________________________

Occurs when a document is archived.

Action

Before
After
Failure
___________

WorkflowActionEventArgs<TreeNode, BaseInfo, WorkflowActionEnum>

Requires references to:

  • CMS.WorkflowEngine
  • CMS.DataEngine

Occurs when executing advanced workflow action steps.

Document versioning
SaveVersion

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • VersionHistory (VersionHistoryInfo)

  • VersionNumber (string)
  • VersionComment (string)
  • TreeProvider (TreeProvider)

Occurs when the edited version of a document is updated.
SaveAttachmentVersion

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • Attachment (AttachmentInfo)

  • TreeProvider (TreeProvider)

Occurs when an attachment is updated or inserted for the edited version of a document.
RemoveAttachmentVersion

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • Attachment (AttachmentInfo)

  • TreeProvider (TreeProvider)

Occurs when an attachment is removed for the edited version of a document.
Content locking
CheckOut

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a document is checked-out.
CheckIn

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a document is checked-in.
UndoCheckOut

Before
After
Failure

WorkflowEventArgs

  Properties
  • Document (TreeNode)

  • TreeProvider (TreeProvider)

Occurs when a user performs the undo check-out action.

> Back to list of event categories

SecurityEvents

Namespace: CMS.Membership

Contains security and authentication events.

Event

Event types

Handler parameters

Description

Authenticate
_______________________
Execute
___________

AuthenticationEventArgs

  Properties
  • User (UserInfo)

  • UserName (string)

  • Password (string)

Occurs when authenticating users.

See also: Handling custom external authentication

AuthenticationRequested Execute

AuthenticationRequestEventArgs

  Properties
  • RequestedUrl (string)

Occurs when a user accesses a restricted section of Kentico and the user's authentication is required.

MultiFactorAuthenticate

Execute

AuthenticationEventArgs

  Properties
  • Passcode (string)
  • UserName (string)

  • Password (string)

Occurs when a user tries to sign in to Kentico with multi-factor authentication enabled.

AuthorizeResource

Execute

AuthorizationEventArgs

  Properties
  • User (UserInfo)

  • ResourceName (string)

  • PermissionName (string)

  • Authorized (bool)

Occurs when checking the permissions for modules.

AuthorizeClass

Execute

AuthorizationEventArgs

  Properties
  • User (UserInfo)

  • ClassName (string)

  • PermissionName (string)

  • Authorized (bool)

Occurs when performing security checks for object type or document type permissions.

AuthorizeUIElement Execute

AuthorizationEventArgs

  Properties
  • User (UserInfo)

  • ElementName (string)

  • PermissionName (string)

  • Authorized (bool)

Occurs when checking permissions for UI elements.

SignOut

Before
After
Failure

SignOutEventArgs

  Properties
  • User (UserInfo)

  • SignOutUrl (string)

Occurs when a user signs out from a website.

> Back to list of event categories

StagingEvents

Namespace: CMS.Synchronization

Contains events that occur when using content staging for documents and objects.

Event

Event types

Handler parameters

Description

LogTask
_______________________

Before
After
Failure

StagingLogTaskEventArgs

  Properties
  • Object (BaseInfo)

  • Task (StagingTaskInfo)

Occurs when creating staging tasks on the source server after a document or object is changed in the system.

See also:

Synchronize

Before
After
Failure

CMSEventArgs

Occurs on the source server when synchronizing staging tasks — once per synchronize action, even when processing multiple tasks.

SynchronizeTask

Before
After
Failure

StagingTaskEventArgs

  Properties
  • Task (StagingTaskInfo)

Occurs on the source server when synchronizing staging tasks — separately for every processed task.

ProcessTask

Before
After
Failure
___________

StagingSynchronizationEventArgs

  Properties
  • TaskType (TaskTypeEnum)

  • ObjectType (string)

  • TaskData (DataSet)

  • TaskBinaryData (DataSet)

  • TaskHandled (bool)
  • SyncManager (ISyncManager)

Occurs on the target server when processing incoming staging tasks.

The processing of the staging tasks then also triggers the corresponding ObjectEvents (Insert, Update, Delete, etc.). If the CMSStagingUseTreeCustomHandlers web.config key is set to true, the DocumentEvents are triggered, too.

> Back to list of event categories

IntegrationEvents

Namespace: CMS.Synchronization

Contains events that occur when synchronizing documents or objects between Kentico and other applications using the integration bus.

See also:

Event

Event types

Handler parameters

Description

LogInternalTask
_______________________

Before
After
Failure

IntegrationTaskEventArgs

  Properties
  • Task (IntegrationTaskInfo)

  • Object (BaseInfo)

Occurs when creating outgoing integration tasks after a document or object in the system is changed.

LogExternalTask

Before
After
Failure
___________

IntegrationTaskEventArgs

  Properties
  • Task (IntegrationTaskInfo)

  • Object (BaseInfo)

 Occurs when the system creates incoming tasks provided by an integration connector.

> Back to list of event categories

ImportExportEvents

Namespace: CMS.CMSImportExport

Contains events related to import and export actions.

Event

Event types

Handler parameters

Description

Import
_______________________

Before
After
Failure

ImportBaseEventArgs

  Properties
  • Settings (SiteImportSettings)

Occurs at the start of the import process.
ImportObject

Before
After
Failure

ImportEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Object (BaseInfo)

  • ParentObject (BaseInfo)

  • Parameters (ImportParameters)

Occurs once for every imported object.
ImportObjects

Before
After
Failure

ImportDataEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Data (DataSet)

  • ObjectType (string)

  • SiteObjects (bool)

  • ParentImported (bool)

Occurs when importing sets of objects.
ImportBinding

Before
After
Failure

ImportEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Object (BaseInfo)

  • ParentObject (BaseInfo)

  • Parameters (ImportParameters)

Occurs once for every imported binding object.
ImportBindings

Before
After
Failure

ImportEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Object (BaseInfo)

  • ParentObject (BaseInfo)

  • Parameters (ImportParameters)

Occurs when importing binding objects.
ImportChild

Before
After
Failure

ImportEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Object (BaseInfo)

  • ParentObject (BaseInfo)

  • Parameters (ImportParameters)

Occurs once for every imported child object.
ImportChildren

Before
After
Failure

ImportEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Object (BaseInfo)

  • ParentObject (BaseInfo)

  • Parameters (ImportParameters)

Occurs when importing child objects.
GetImportData

Before
After
Failure

ImportGetDataEventArgs

  Properties
  • Settings (SiteImportSettings)

  • Data (DataSet)
  • Object (BaseInfo)

  • ObjectType (string)
  • SiteObjects (bool)

  • SelectionOnly (bool)

Occurs when importing data. Allows you to work with the data set in the import package created for a specific object types.

  • Use the Before event type to modify the data in the import package (for example add data from an external source).
  • Use the After event type to modify the data after the import package has been loaded.
ProcessFileOperation

Before
After
Failure

ImportProcessFileOperationEventArgs

  Properties
  • Operation (FileOperation)

  • Settings (SiteImportSettings)

Occurs when processing file/folder operations in the import package.
ImportCanceled Execute

ImportBaseEventArgs

  Properties
  • Settings (SiteImportSettings)

Occurs when a user cancels the import process.
ImportError Execute
___________

ImportErrorEventArgs

  Properties
  • Exception (Exception)

  • Settings (SiteImportSettings)

Fires when an error occurs during the import process.

Event

Event types

Handler parameters

Description

Export
_______________________

Before
After
Finished
Failure

ExportEventArgs

  Properties
  • Settings (SiteExportSettings)

  • SiteObjects (bool)
    __________________________

Occurs at the start of the export process.
ExportObjects

Before
After
Failure

ExportEventArgs

  Properties
  • Settings (SiteExportSettings)

  • Data (DataSet)

  • ObjectType (string)

  • SiteObjects (bool)
    __________________________

Occurs when exporting objects.
GetExportData

Before
After
Failure

ExportGetDataEventArgs

  Properties
  • Settings (SiteExportSettings)

  • Data (DataSet)

  • ObjectType (string)

  • WhereCondition (string)

  • ChildData (bool)

  • SelectionOnly (bool)

  • Parameters(QueryDataParameters)
    ______________________________

Occurs when exporting data. Allows you to work with the data set in the export package created for specific object types.

  • Use the Before event type to extract data from the export package.
  • Use the After event type to modify the data in the export package.
SingleExportSelection Execute

SingleExportSelectionEventArgs

  Properties
  • Settings (SiteExportSettings)

  • InfoObject (BaseInfo)

  • SelectedObject (List<string>)
    __________________________

Occurs when selecting related objects during single object export. Allows you to attach related objects to the export package.
ExportCanceled Execute

ExportBaseEventArgs

  Properties
  • Settings (SiteExportSettings)
    __________________________

Occurs when a user cancels the export process.
ExportError Execute
___________

ExportErrorEventArgs

  Properties
  • Exception (Exception)
  • Settings (SiteExportSettings)
    __________________________

Fires when an error occurs during the export process.

> Back to list of event categories

DocumentImportExportEvents

Namespace: CMS.DocumentEngine

Contains events related to import and export of documents.

Event

Event types

Handler parameters

Description

ExportDocuments
_______________________

Before
After
Failure

DocumentsExportEventArgs

  Properties
  • Settings (SiteExportSettings)

  • Data (DataSet)

  • ObjectType (string)

  • SiteObjects (bool)
    __________________________

Occurs when exporting documents.

ImportDocument

Before
After
Failure

DocumentImportEventArgs

  Properties
  • Document (TreeNode)
  • Settings (SiteImportSettings)

Occurs once for every imported document.
ImportDocuments

Before
After
Failure

DocumentImportEventArgs

  Properties
  • Document (TreeNode)
  • Settings (SiteImportSettings)

Occurs when importing documents.

> Back to list of event categories

ColumnsTranslationEvents

Namespace: CMS.DataEngine

When transferring data between instances of Kentico (via import/export or staging), the IDs of objects can differ between the environments. Kentico automatically "translates" the ID values for system objects, but not for custom objects. For example, when you stage a custom table or document type that contains a custom field storing object IDs, the values may not match the IDs of the objects on the target server. The ColumnsTranslationEvents allow you to ensure that the IDs are translated correctly.

See also: Deploying objects with custom ID fields

Event

Event types

Handler parameters

Description

RegisterRecords
_______________________

Execute

ColumnsTranslationEventArgs

  Properties
  • ObjectType (string)

  • Data (IDataContainer)

  • TranslationHelper (TranslationHelper)
    ______________________________

Occurs when exporting objects. Allows you to provide additional information for the translation of custom ID fields.

TranslateColumns

Execute
___________

ColumnsTranslationEventArgs

  Properties
  • ObjectType (string)

  • Data (IDataContainer)

  • TranslationHelper (TranslationHelper)
    ______________________________
Occurs when importing objects. Allows you to translate the values of custom ID fields using the provided information.

> Back to list of event categories

BizFormItemEvents

Namespace: CMS.OnlineForms

Contains events related to form actions. See Working with form data using the API for an example.

Event

Event types

Handler parameters

Description

Insert
_______________________

Before
After
Failure

BizFormItemEventArgs

  Properties
  • Item (BizFormItem)

Occurs when inserting new form items (data records of on-line forms).
Update

Before
After
Failure

BizFormItemEventArgs

  Properties
  • Item (BizFormItem)

Occurs when updating form data records.
Delete

Before
After
Failure
___________

BizFormItemEventArgs

  Properties
  • Item (BizFormItem)

Occurs when deleting data records from forms.

> Back to list of event categories

NewsletterEvents

Namespace: CMS.Newsletter

Event Event types Handler parameters Description
ResolveMacros
_______________________
Before
After
Failure __________

ResolveMacroEventArgs

  Properties
  • MacroResolver (MacroResolver)
  • TextToResolve (string)
  • Newsletter (NewsletterInfo)
  • Issue (IssueInfo)_______________________
Fires when all newsletter text macros are being resolved.

> Back to list of event categories

WebAnalyticsEvents

Namespace: CMS.WebAnalytics

Event

Event types

Handler parameters

Description

LogConversion
_______________________

Before
After
Failure
___________

CMSEventArgs<LogRecord>

  Properties
  • Conversion (LogRecord)
    _______________________

Occurs when a conversion is logged.

ProcessLogRecord Before
After
Failure

CMSEventArgs<LogRecord>

  Properties
  • LogRecord (LogRecord)
    ______________________

Occurs when the web analytics log is being processed.

ActivityEvents

Namespace: CMS.WebAnalytics

Event

Event types

Handler parameters

Description

ActivityLogged
_______________________

Before
After
Failure
___________

ActivityLoggedEventArgs

  Properties
  • ActivityData (ActivityData)
    _______________________

Fires immediately when on-line marketing activities of any type occur in the system.

The event does not trigger for custom activities logged using the ActivityInfoProvider.SetActivityInfo method.

> Back to list of event categories

AutomationEvents

Namespace: CMS.Automation

Contains events related to marketing automation actions.

Event

Event types

Handler parameters

Description

MoveToNextStep
_______________________

Before
After
Failure

AutomationEventArgs

  Properties
  • InfoObject (BaseInfo)

  • StateObject (AutomationStateInfo)

  • PreviousStep (WorkflowStepInfo)

Occurs when an automation process moves to the next step.
MoveToPreviousStep

Before
After
Failure

AutomationEventArgs

  Properties
  • InfoObject (BaseInfo)

  • StateObject (AutomationStateInfo)

  • PreviousStep (WorkflowStepInfo)

Occurs when an automation process moves back to the previous step.
Action

Before
After
Failure
___________

WorkflowActionEventArgs<BaseInfo, AutomationStateInfo, AutomationActionEnum>

Requires references to:

  • CMS.WorkflowEngine
  • CMS.DataEngine
Occurs when the system executes a marketing automation action step.
ProcessTrigger

Before
After
Failure

AutomationProcessTriggerEventArgs

  Properties
  • Options (TriggerOptions)

  • TriggerInfo (ObjectWorkflowTriggerInfo)

Occurs when processing triggers for automation processes.

Evaluates the trigger condition and allows you to, for example, insert data into the condition.

> Back to list of event categories

URLRewritingEvents

Namespace: CMS.URLRewritingEngine

Contains events related to URL rewriting and page redirection.

Event

Event types

Handler parameters

Description

PageNotFound
_______________________

Before
After
Failure
___________

URLRewritingEventArgs

  Properties
  • Parameters (URLRewritingParams)

Occurs when the system redirects users to a Page not found error page (after requesting a URL that returns a 404 HTTP status code).
ProcessRewritingResult

Before
After
Failure

 URLRewritingEventArgs

  Properties
  • Parameters (URLRewritingParams)

Occurs at the end of the rewriting process for all URLs. If there are redirects during the rewriting, the event is only triggered for the final URL at the end of the process.

Use the Before event if you need to perform custom rewriting. Use the After event to perform additional custom actions after the default rewriting.

ProcessABTest Execute

ProcessABTestEventArgs

  Properties
  • PageInfo (PageInfo)
  • ReturnedPageInfo (PageInfo)
  • SiteName (String)
  • ViewMode (ViewModeEnum)
Occurs when the system starts rewriting the URL of a page with a running A/B test.

SystemEvents

Namespace: CMS.Base

Contains general system events.

Event

Event types

Handler parameters

Description

Exception
_______________________

Execute
___________

SystemEventArgs

  Properties
  • Exception (Exception)

  • LogException (bool)

Fires when an unhandled exception occurs in the system.

SiteEvents

Namespace: CMS.SiteProvider

Contains events related to site actions.

Event

Event types

Handler parameters

Description

Delete
_______________________

Before
After
Failure
___________

SiteDeletionEventArgs

  Properties
  • User (UserInfo)

  • Context (CMSActionContext)

  • Info (DeletionInfo)

Occurs when a site is deleted from the system.

> Back to list of event categories

SqlEvents

Namespace: CMS.DataEngine

Contains events related to the execution of queries and other database operations.

Event

Event types

Handler parameters

Description

ExecuteQuery
_______________________

Before
After
Failure
___________

ExecuteQueryEventArgs<DataSet>

  Properties
  • Connection (IDataConnection)

  • Query (QueryParameters)

  • Result (DataSet)

Occurs when the system executes a database query.

See also: Working with database queries in the API

ExecuteNonQuery

Before
After
Failure

ExecuteQueryEventArgs<int>

  Properties
  • Connection (IDataConnection)

  • Result (DataSet)

Occurs when the system executes a non-query database operation.

ExecuteScalar

Before
After
Failure

ExecuteQueryEventArgs<object>

  Properties
  • Connection (IDataConnection)

  • Query (QueryParameters)

  • Result (DataSet)

Occurs when the system executes a scalar query.
ExecuteReader

Before
After
Failure

ExecuteQueryEventArgs<DbDataReader>

  Properties
  • Connection (IDataConnection)

  • Result (DataSet)

Occurs when the system runs a database DataReader.

> Back to list of event categories

Application events

Kentico provides a set of events that you can use to customize the global behavior of the application.

ApplicationEvents

Namespace: CMS.Base

Contains events related to the application life cycle.

The following table lists the events that occur once in the application's life cycle, in order of execution:

Event

Event types

Handler parameters

Description

PreInitialized
_______________________
Execute
___________
EventArgs
___________________

Occurs when the application finishes pre-initialization (preparation of things unrelated to the database).

Handlers need to be assigned in the PreInit method of modules or CMSLoaderAttribute classes in App_Code.

Initialized Execute EventArgs Occurs when the application finishes initialization and starts (including the database connection). Handle this event to perform standard application start events.
PostStart Execute EventArgs Occurs at the end of the first application request. Allows you to perform asynchronous tasks needed for application startup that do not influence the output of requests.
End

Execute

EventArgs

Occurs when the application ends.

The following events occur as needed during the application life cycle:

Event

Event types

Handler parameters

Description

Error

Execute

EventArgs Fires when an error occurs in the application.
SessionStart Execute EventArgs Occurs when an HTTP session starts for a client.
SessionEnd Execute EventArgs Occurs when an HTTP session ends for a client. May not be raised if the application is configured to use a session state mode different than InProc.
GetVaryByCustomString
_______________________
Execute
___________

GetVaryByCustomStringEventArgs

  Properties
  • Result (string)

  • Context (HttpContext)

  • Custom (string)

Occurs when the application processes variables in custom names of output cache keys.

RequestEvents

Namespace: CMS.Base

Contains events related to handling of requests. See also: ASP.NET Application Life Cycle Overview

The following table lists the request events in order of execution:

Event

Event types

Handler parameters

Description

Prepare Execute

EventArgs

Occurs before the request processing begins.
Begin Execute

EventArgs

Occurs when the request processing starts.

Authenticate Execute EventArgs Occurs when authenticating requests.
Authorize Execute EventArgs Occurs when authorizing requests. If the application loads the response from the output cache, the life cycle skips to the End event.
PostAuthorize Execute EventArgs Occurs after the request's user is authorized.
MapRequestHandler Execute EventArgs

Occurs when a handler is selected to respond to the request. The system performs URL rewriting during the event. After this event, the application can access the context of the displayed page and current document (page info).

PostMapRequestHandler Execute EventArgs

Occurs when the application has mapped the request to the appropriate event handler.

AcquireRequestState

Execute

EventArgs Occurs when acquiring the request state.
End Execute EventArgs Occurs at the end of the request processing (last chance to perform actions before the client receives the response).
RunEndRequestTasks Execute EventArgs Allows you to execute background tasks at the end of the request processing, but cannot influence the response sent to the client.
Finalize
_______________________
Execute
___________
EventArgs
___________________
Occurs when the request is finalized. Use to cleanup and release any resources used by the request.

Handling other HttpApplication events

If you wish to handle HttpApplication events that are not available in the Kentico RequestEvents class, you need to create and register a custom HTTP module. You can implement the module in the App_Code folder of web site projects or as part of a custom assembly.

See Walkthrough: Creating and Registering a Custom HTTP Module for more information.

SessionEvents

Namespace: CMS.Membership

Contains events related to session management.

Event

Event types

Handler parameters

Description

UpdateSession

Before
After
Failure

CMSEventArgs Occurs when an HTTP session is updated.
UpdateSessionData

Execute
___________

CMSEventArgs<SessionInfo>

  Properties
  • Parameter (SessionInfo)

Occurs when the data of an HTTP session is updated.

> Back to list of event categories

Control and page events

You can handle events related to the life cycle of pages and controls. The events are defined directly in the base classes of system pages and controls. You can leverage the events to customize the user interface. The events are direct delegates.

AbstractUserControl

Namespace: CMS.ExtendedControls

Contains events that occur during the user control life cycle.

Event

Handler parameter

Handler return type

OnBeforeUserControlInit EventArgs bool
OnAfterUserControlInit EventArgs void
OnBeforeUserControlLoad EventArgs bool
OnAfterUserControlLoad EventArgs void
OnBeforeUserControlPreRender EventArgs bool
OnAfterUserControlPreRender EventArgs void
OnBeforeUserControlRender HtmlTextWriter bool
OnAfterUserControlRender HtmlTextWriter void

Return true in Before handlers to perform the default system actions for the given event.

CMSPage

Namespace: CMS.UIControls

Contains events that occur during the system page life cycle.

Event

Handler parameter

Handler return type

OnBeforePagePreInit EventArgs bool
OnAfterPagePreInit EventArgs void
OnBeforePageInit EventArgs bool
OnAfterPageInit EventArgs void
OnBeforePageLoad EventArgs bool
OnAfterPageLoad EventArgs void
OnBeforePagePreRender EventArgs bool
OnAfterPagePreRender EventArgs void
OnBeforePageRender HtmlTextWriter bool
OnAfterPageRender HtmlTextWriter void

Return true in Before handlers to perform the default system actions for the given event.

> Back to list of event categories