GenoPro Home
GenoPro Home  |  SDK Home  |  Report Generator  |  Support  |  Search  |  Help  |  Site Map

Skip Navigation Links.

Session Class

The Session is a repertory to share data between pages. The report generator resets the script at the beginning of each page and the Session object is the only mechanism to preserve data when the script terminates. Please notice the Session is for sharing data between pages, not between reports. You get a new Session object each time you generate a report.

Syntax:
The Session object is an instance of the ObjectRepertory class. Whatever you can do with an ObjectRepertory, you can do it with the Session object.

Session(strKey) = oGenericObject		' Store generic object to the Session
Set oGenericObject = Session(strKey)	' Retrieve generic object from the session

Usage:
There are many uses for the Session object. For instance, you may have one page displaying all the names sorted alphabetically and want to have another page displaying an index of those names. Instead of repeating the code to generate a full list of names and to generate the index, you can use the Session to store the unique names. Later, you can retrieve the unique names from the session and generate the index of names. Similarly, you may have one page generating a picture album and another page creating a summary of the picture album. Instead of repeating the code on two pages, you can use the Session object to store picture summary details.

Syntax:
The Session object is an instance of the ObjectRepertory class. Whatever you can do with with an ObjectRepertory, you can do it with the Session object.

Set oDictionary = Util.NewStringDictionary()
Session("oDictionary") = oDictionary
Session("strTitleReport") = "My Report"
Session("cMaximumPicturesPerPage") = 20
To access an object from the Session, use the following syntax:
Set oDictionary = Session("oDictionary")
Report.WriteText Session("strTitleReport")
cPicturesMax = Session("cMaximumPicturesPerPage")

Tip:
You will find sample code using the Session object in the file Init.htm. The code is well documented and you can modify it to tweak the report to your needs.

Memory Life Cycle:
Any object or value stored in the Session object will be automatically freed when the report engine shuts down. You don't have to any special processing to unload the objects from memory - GenoPro does it automatically for you. To explicitly unload an object from memory, just set its value to Nothing.

Session("oDictionary") = Nothing

See Also:
GenoObject.Session
ObjectRepertory
 

 

Copyright ┬ę 1998-2017. All rights reserved. GenoPro┬« and the GenoPro logo are registered trademarks.