Draft for Information Only

Content


        Application Object
 Application.Lock Method
  
        Syntax:
  
  Parameters:
  
        Return Values:
  
        Remarks:
  Examples:
 Application.Unlock Method
  
        Syntax:
  
  Parameters:
  
  Parameters:
  
        Remarks:
  Examples:

Application Object

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

Application.Lock Method

Application.Lock method locks the properties of Application object by only one client at a time for preventing other clients from modification..

Syntax:

Lock(
)

Or in an ASP file. Imply

<% Application.Lock %>

Parameters:

void

This method has no parameters

Return Values:

void

This method has no parameters

Remarks:

After calling the Application.Lock method, if the Application.Unlock method is not called explicitly, the server unlocks the locked Application object when the ASP file processing ends or times out. Therefore a lock on the Application object only persists for a very short time.

However, if one page locks the application object and a second page tries to locks the same application object while the first page still has it locked, the second page will wait for the first to finish, or until the Server.ScriptTimeout limit is reached.

If the Server.ScriptTimeout limit is reached, the following ASP error is returned which cannot be captured:

HTTP 500.100 - Internal Server Error - ASP error
Internet Information Services

Active Server Pages, ASP 0113 (0x80004005)
The maximum amount of time for a script to execute was exceeded.
You can change this limit by specifying a new value for the property
Server.ScriptTimeout or by changing the value in the IIS administration tools

To reduce the possibility of having an ASP page time out, write a COM+ object that uses the COM+ ObjectContext object to update the Application collection, and then call the COM+ object from an ASP. COM+ objects execute slightly faster than ASP pages.

The application collection can be modified without locking the application object to edit. Therefore two pages can modify the same application without causing any error, however, the modification will become inconsistent.

Examples:

Use Application.Lock to prevent more than on client accessing and altering the application variable simultaneously

ASP script command:

<%
Application.Lock
Application("CountNo") = Application("CountNo") + 1
Application.Unlock
%>

Application.Unlock Method

Application.UnlLock method unlocks or releases the properties of Application object by the only one client at a time for allowing other clients to modify.

Syntax:

Unlock(
)

Or in an ASP file. Imply

<% Application.Unlock %>

Parameters:

void

This method has no parameters

Parameters:

void

This method has no parameters

Remarks:

The Application.Lock method is cumulative, therefore for the same script, the number of Lock method calls should be equal to the number of Unlock method calls in order to fully release the application, otherwise the application remains Locked.

After calling the Application.Lock method , if the Application.Unlock method is not called explicitly, the server unlocks the locked Application object when the ASP file processing ends or times out. Therefore a lock on the Application object only persists for a very short time.

If the Server.ScriptTimeout limit is reached, the following ASP error is returned which cannot be captured:

Examples:

Use same number of Application.Unlock to release the application for other clients accessing and altering the application variable simultaneously

ASP script command:

<%
Application.Lock
Application.Lock
Application("CountNo") = Application("CountNo") + 1
Application.Unlock
Application.Unlock
%>

©sideway

ID: 120200035 Last Updated: 2/10/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