Session Object | |
The Session object is created for each visitor when they first request an ASP page from the site, and remains available until the default timeout period (or the timeout period determined by the script) expires. It provides a repository for storing variables and object references that are available just to the pages that this visitor opens during the lifetime of this session. | |
Contents | |
Collection | |
A collection of all the variables and their values that are stored in this particular Session object, and are not defined using an <OBJECT> element. This includes Variant arrays and Variant-type object instance references. |
StaticObjects | |
Collection | |
A collection of all of the variables that are stored in this particular Session object by using an <OBJECT> element. |
CodePage | |
Integer | Property |
Read/write. Defines the code page that will be used to display the page content in the browser. The code page is the numeric value of the character set, and different languages and locales may use different code pages. For example, ANSI code page 1252 is used for American English and most European languages. Code page 932 is used for Japanese Kanji.. |
LCID | |
Integer | Property |
Read/write. Defines the locale identifier (LCID) of the page that is sent to the browser. The LCID is a standard international abbreviation that uniquely identifies the locale; for instance 2057 defines a locale where the currency symbol used is '£'. This LCID can also be used in statements such as FormatCurrency, where there is an optional LCID argument. The LCID for a page can also be set in the opening <%@..%> ASP processing directive and overrides the setting in the LCID property of the session. |
SessionID | |
Property | |
Long. Read only. Returns the session identifier for this session, which is generated by the server when the session is created. Unique only for the duration of the parent Application object and so may be re-used when a new application is started. |
Timeout | |
Integer | Property |
Read/write. Defines the timeout period in minutes for this Session object. If the user does not refresh or request a page within the timeout period, the session ends. Can be changed in individual pages as required. The default is 20 minutes, and shorter timeouts may be preferred on a high-usage site. |
Contents.Remove("variable_name") | |
Method | |
Removes a named variable from the Session.Contents collection. |
Contents.RemoveAll() | |
Method | |
Removes all variables from the Session.Contents collection. |
Abadon() | |
Method | |
Ends the current user session and destroys the current Session object once execution of this page is complete. You can still access the current session's variables in this page, even after calling the Abandon method. However the next ASP page that is requested by this user will start a new session, and create a new Session object with only the default values defined in global.asa (if any exist). |
onStart | |
Event | |
Occurs when an ASP user session starts, before the first page that the user requests is executed. Used to initialize variables, create objects, or run other code. |
onEnd | |
Event | |
Occurs when an ASP user session ends. This is when the predetermined session timeout period has elapsed since that user's last page request from the application. All variables existing in the session are destroyed when it ends. It is also possible to end ASP user sessions explicitly in code, and this event occurs when that happens. |