Session Object

Session object of ASP is related to the manipulation of information about the session of a client on the server.

Methods

Method	Description
Abandon	Abandon or destroy a Session object and release all related resources.
Contents.Remove	Remove or delete an item from the Contents collection of Session object.
Contents.RemoveAll	Remove or delete all items from the Contents collection of Session object.

Properties

Property	Description
CodePage	Add or set the CodePage for data in the intrinsic objects within the entire session.
Contents (Collection)	Add or set the value of an item of the Contents collection of Session object through script commands.
LCID	Set the value of LCID for the data of response in the intrinsic objects to specify the format of dates, times, and currency for different geographical locale for an entire session.
SessionID	Return the unique of LONG data type session identifier generated by the server during the creation of the new session.
StaticObjects (Collection)	Collection of all objects added to the current session through the <OBJECT> tag within the session scope
Timeout	Set the length of time out period for the Session object of the application that allowing the client to refresh or request a page on the server before the end of session on the server.

Events

Event	Description
Session_OnEnd	Event occurs on the end of a Session when the Session is either abandoned or times out.
Session_OnStart	Event occurs on the start of a Session when a new Session is created by the server.

Remarks

All items in the collections of Session object is available within the scope of entire session for a client in the application.
A Session object with unique Session Identifier is created by the web server automatically when a web page from the application is requested by a client without a Session Identifier or does not already have a session. Therefore a client jumps between pages in the application will have the same Session object and session identifier. The Session object will be destroyed by the server once the session is abandoned or is destroyed.
An object instance of a component can be assigned to an item of a Contents Collection through the Server.CreateObject method with the Set keyword.
And an embedded object can also be assigned to an item of a StaticObjects Collection through the <OBJECT> tag
However, only threading model of objects marked as BOTH can be stored in the Session object, because the session is not locked to a single thread
But all built-in objects cannot be assigned to neither a Content Collection nor a StaticObjects Collection.
Besides, an array can also be assigned to an item of a Contents Collection in the form of a collection, but the elements of the stored array in the Contents Collection cannot be manipulated as an ordinary array directly because the array is stored as a collection.
The methods and properties of ASP Session object can be grouped into
- Setup/Event: Session_OnEnd; Session_OnStart
- Session Control: Abandon; SessionID; Timeout
- Session Setup: CodePage; LCID
- Embedded Object: StaticObjects
- Variable:iable:
  - Add/Set: Contents;
  - Remove: Contents.Remove; Contents.RemoveAll

©sideway

ID: 120100026 Last Updated: 1/27/2012 Revision: 0 Ref:

References

Active Server Pages, , http://msdn.microsoft.com/en-us/library/aa286483.aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929%28v=vs.90%29.aspx
ASP Best Practices, , http://technet.microsoft.com/en-us/library/cc939157.aspx
ASP Built-in Objects, , http://msdn.microsoft.com/en-us/library/ie/ms524716(v=vs.90).aspx
Response Object, , http://msdn.microsoft.com/en-us/library/ms525405(v=vs.90).aspx
Request Object, , http://msdn.microsoft.com/en-us/library/ms524948(v=vs.90).aspx
Server Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525541(v=vs.90).aspx
Application Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525360(v=vs.90).aspx
Session Object (IIS), , http://msdn.microsoft.com/en-us/library/ms524319(8v=vs.90).aspx
ASPError Object, , http://msdn.microsoft.com/en-us/library/ms524942(v=vs.90).aspx
ObjectContext Object (IIS), , http://msdn.microsoft.com/en-us/library/ms525667(v=vs.90).aspx
Debugging Global.asa Files, , http://msdn.microsoft.com/en-us/library/aa291249(v=vs.71).aspx
How to: Debug Global.asa files, , http://msdn.microsoft.com/en-us/library/ms241868(v=vs.80).aspx
Calling COM Components from ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524620(v=VS.90).aspx
IIS ASP Scripting Reference, , http://msdn.microsoft.com/en-us/library/ms524664(v=vs.90).aspx
ASP Keywords, , http://msdn.microsoft.com/en-us/library/ms524672(v=vs.90).aspx
Creating Simple ASP Pages, , http://msdn.microsoft.com/en-us/library/ms524741(v=vs.90).aspx
Including Files in ASP Applications, , http://msdn.microsoft.com/en-us/library/ms524876(v=vs.90).aspx
ASP Overview, , http://msdn.microsoft.com/en-us/library/ms524929(v=vs.90).aspx
FileSystemObject Object, , http://msdn.microsoft.com/en-us/library/z9ty6h50(v=vs.84).aspx
http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx, , ADO Object Model
ADO Fundamentals, , http://msdn.microsoft.com/en-us/library/windows/desktop/ms680928(v=vs.85).aspx