Sideway
output.to from Sideway





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.

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 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
close

References

  1. Active Server Pages, http://msdn.microsoft.com/en-us/library/aa286483.aspx, updated 20Dec2012
  2. ASP Overview, http://msdn.microsoft.com/en-us/library/ms524929%28v=vs.90%29.aspx, updated 21Dec2012
  3. ASP Best Practices, http://technet.microsoft.com/en-us/library/cc939157.aspx, updated 15Apr2013
  4. ASP Built-in Objects, http://msdn.microsoft.com/en-us/library/ie/ms524716(v=vs.90).aspx, updated 20Dec2012
  5. Response Object, http://msdn.microsoft.com/en-us/library/ms525405(v=vs.90).aspx, updated 20Dec2012
  6. Request Object, http://msdn.microsoft.com/en-us/library/ms524948(v=vs.90).aspx, updated 20Dec2012
  7. Server Object (IIS), http://msdn.microsoft.com/en-us/library/ms525541(v=vs.90).aspx, updated 20Dec2012
  8. Application Object (IIS), http://msdn.microsoft.com/en-us/library/ms525360(v=vs.90).aspx, updated 20Dec2012
  9. Session Object (IIS), http://msdn.microsoft.com/en-us/library/ms524319(8v=vs.90).aspx, updated 20Dec2012
  10. ASPError Object, http://msdn.microsoft.com/en-us/library/ms524942(v=vs.90).aspx, updated 20Dec2012
  11. ObjectContext Object (IIS), http://msdn.microsoft.com/en-us/library/ms525667(v=vs.90).aspx, updated 20Dec2012
  12. Debugging Global.asa Files, http://msdn.microsoft.com/en-us/library/aa291249(v=vs.71).aspx, updated 15Apr2013
  13. How to: Debug Global.asa files, http://msdn.microsoft.com/en-us/library/ms241868(v=vs.80).aspx, updated 15Apr2013
  14. Calling COM Components from ASP Pages, http://msdn.microsoft.com/en-us/library/ms524620(v=VS.90).aspx, updated 15Apr2013
  15. IIS ASP Scripting Reference, http://msdn.microsoft.com/en-us/library/ms524664(v=vs.90).aspx, updated 15Apr2013
  16. ASP Keywords, http://msdn.microsoft.com/en-us/library/ms524672(v=vs.90).aspx, updated 15Apr2013
  17. Creating Simple ASP Pages, http://msdn.microsoft.com/en-us/library/ms524741(v=vs.90).aspx, updated 15Apr2013
  18. Including Files in ASP Applications, http://msdn.microsoft.com/en-us/library/ms524876(v=vs.90).aspx, updated 15Apr2013
  19. ASP Overview, http://msdn.microsoft.com/en-us/library/ms524929(v=vs.90).aspx, updated 15Apr2013
  20. FileSystemObject Object, http://msdn.microsoft.com/en-us/library/z9ty6h50(v=vs.84).aspx, updated 14Mayr2013
  21. http://msdn.microsoft.com/en-us/library/windows/desktop/ms675944(v=vs.85).aspx, ADO Object Model, updated 15Apr2013
  22. ADO Fundamentals, http://msdn.microsoft.com/en-us/library/windows/desktop/ms680928(v=vs.85).aspx, updated 14Mayr2013
close

ID: 120200035 Last Updated: 2/10/2012 Revision: 0 Ref:

IMAGE

Home (5)

Business

Management

HBR (3)

Information

Recreation

Hobbies (7)

Culture

Chinese (1097)

English (336)

Reference (66)

Computer

Hardware (149)

Software

Application (187)

Digitization (24)

Numeric (19)

Programming

Web (644)new

CSS (SC)

ASP.NET (SC)

Regular Expression (SC)

HTML

Knowledge Base

Common Color (SC)

Html Entity (Unicode) (SC)

Html 401 Special (SC)

OS (389)new

MS Windows

Windows10 (SC)

.NET Framework (SC)

DeskTop (7)

Knowledge

Mathematics

Formulas (8)

Number Theory (206)

Algebra (20)

Trigonometry (18)

Geometry (18)

Calculus (67)

Complex Analysis (21)

Engineering

Tables (8)

Mechanical

Mechanics (1)

Rigid Bodies

Statics (92)

Dynamics (37)

Fluid (5)

Fluid Kinematics (5)

Control

Process Control (1)

Acoustics (19)

FiniteElement (2)

Biology (1)

Geography (1)

Latest Updated Links

Copyright © 2000-2019 Sideway . All rights reserved Disclaimers last modified on 10 Feb 2019