Content


        Session Object
 Session_OnStart Event
  
        Syntax:
  
  Parameters:
  
        Remarks:
  Examples:
 Session_OnEnd Event
  
        Syntax:
  
  Parameters:
  
        Remarks:
  Examples:

Session Object

One of the key functions of Session Object is the application control on the server.

Session_OnStart Event

Session_OnStart Event occurs on the start of a Session when a new Session is created by the server.

Syntax:

<SCRIPT LANGUAGE=ScriptLanguage RUNAT=Server>
Sub Session_OnStart
...Script...
End Sub
</SCRIPT>

Or in Global.asa. Imply

<SCRIPT LANGUAGE=ScriptLanguage RUNAT=Server>
Sub Session_OnStart
...Scripts...
End Sub
</SCRIPT>

Parameters:

ScriptLanguage

The parameter "ScriptLanguage" is used to specify the scripting language used in writing the event script.

Script

The parameter "Script" is the program written by the scripting language for the script interpreter of the Web Server.

Remarks:

The scipting language can be any supported language, such as VBScript or JScript. When more than one event using the same scripting language, all event sub-rountine can be combined under a single set of <SCRIPT> tags.

The script will be processed before executing the requested page. Variables with session scrope should be set with the Session_OnStart so that these variables can be accessed when opening any pages.

In the Session_OnStart script, all the Application Object, Objectcontext Object, Request Object, Response Object, Server Object and Session Object built-in objects are available and can be referenced the Session_Onstart event script.

When Response.Rediret or Response.End methods is called in the Session_OnStart event, the server stops processing the script in both the Global.asa file and in the ASP file. However the declared Session objects can still be available.

By making use of the available session objects, scipts in the Session_OnStart event can be used to control the opening an specifed page by an user through calling the Response.Redirect method.

But when using SessionID cookie to identify an user, the browser should be enabled to use cookies.

Examples:

Use Session_OnStart to specify page start

ASP script command:

<SCRIPT LANGUAGE=ScriptLanguage RUNAT=Server>
Sub Session_OnStart
Session("PageStart") = 1
End Sub
</SCRIPT>

Session_OnEnd Event

Session_OnEnd Event occurs on the end of a Session when the Session is either abandoned or times out.

Syntax:

<SCRIPT LANGUAGE=ScriptLanguage RUNAT=Server>
Sub Session_OnEnd
...ScriptLanguage...
End Sub
</SCRIPT>

Or in Global.asa. Imply

<SCRIPT LANGUAGE=ScriptLanguage RUNAT=Server>
Sub Session_OnEnd
...Scripts...
End Sub
</SCRIPT>

Parameters:

ScriptLanguage

The parameter "ScriptLanguage" is used to specify the scripting language used in writing the event script.

Script

The parameter "Script" is the program written by the scripting language for the script interpreter of the Web Server.

Remarks:

In the Session_OnEnd script, only the Application Object, Server Object, and Session Object of built-in objects are available, however the Server.MapPath method is not available..

And by default, Session_OnEnd runs as the Anonymous User, as defined for the application. If there isn't an Anonymous user, or the Logon for the Anonymous user fails, the OnEnd function will not be called, and an event will be logged.

Examples:

Use Session_OnEnd to specify page end

ASP script command:

<SCRIPT LANGUAGE=ScriptLanguage RUNAT=Server>
Sub Session_OnStart
Session("PageStart") = 1
End Sub
Sub Session_OnEnd
Session("PageStart") = 0
End Sub
</SCRIPT>

©sideway

ID: 120200048 Last Updated: 2/13/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