Session Related Events

Last Updated: 9/21/2008

Sections above here:
Home » Development » Session Management

Sections below here:

Topics in this section:
Session Management
Session Implementation
Storing Additional Data
Session Related Events
Memory Consumption
How Session Management Works

The server controller has events related to session management that are fired for session creation and destruction.

OnNewSession

OnNewSession is fired each time a new user session is created. It passes in two arguments, ASession and VMainForm.

ASession is a reference to the newly created session and can be used to query information about the user or modified with custom information such as creating an object to be stored in the .Data property.

VMainForm is passed as a var parameter. It is initialized to nil and if not set the default main form as specified in the project file (dpr) will be used. VMainForm however can be modified based on parameters passed on the start URL, or based on other criteria to specify a main form for the user. To specify an alternate main form simply create it and return its instance in the VMainForm argument.

OnCloseSession

OnCloseSession is called when a users session is about to be terminated. This occurs either when one of the forms of WebApplication.Terminate is called, or the session has timed out.