ASP Global.asa

asp global.asa 文件

global.asa 文件

global.asa 文件是一个可选的文件,它可包含被 asp 应用程序中每个页面访问的对象、变量和方法的声明。

所有合法的浏览器脚本(javascript、vbscript、jscript、perlscript 等等)都能在 global.asa 中使用。

global.asa 文件只能包含下列内容:

  • application 事件
  • session 事件
  • <object> 声明
  • typelibrary 声明
  • #include 指令

注释:global.asa 文件必须存放在 asp 应用程序的根目录中,而且每个应用程序只能有一个 global.asa 文件。

global.asa 中的事件

在 global.asa 中,您可以告诉 application 和 session 对象当 application/session 开始时做什么,当 application/session 结束时做什么。完成这项任务的代码被放置在事件句柄中。global.asa 文件能包含四种类型的事件:

application_onstart - 此事件会在第一个用户调用 asp 应用程序的第一个页面时发生。此事件会在 web 服务器重启或者 global.asa 文件被编辑之后发生。"session_onstart" 事件会在此事件发生之后立即发生。

session_onstart - 此事件会在每当新用户请求他(她)在 asp 应用程序中的第一个页面时发生。

session_onend - 此事件会在每当用户结束 session 时发生。在规定的时间(默认的时间为 20 分钟)内如果用户没有请求任何页面,用户 session 就会结束。

application_onend - 此事件会在最后一个用户结束其 session 之后发生。典型的情况是,此事件会在 web 服务器停止时发生。这个子程序用于在应用程序停止后清除设置,比如删除记录或者向文本文件中写入信息。

一个 global.asa 文件可能如下所示:

<script language="vbscript" runat="server">

sub application_onstart
'some code
end sub

sub application_onend
'some code
end sub

sub session_onstart
'some code
end sub

sub session_onend
'some code
end sub

</script>

注释:由于我们无法在 global.asa 文件中使用 asp 的脚本分隔符 (<% 和 %>) 插入脚本,我们需要把子例程放置在 html 的 <script> 元素内部。

<object> 声明

可通过使用 <object> 标签在 global.asa 文件中创建带有 session 或者 application 作用域的对象。

注释:<object> 标签应位于 <script> 标签外部!

语法

<object runat="server" scope="scope" id="id" {progid="progid"|classid="classid"}>
....
</object>

参数 描述
scope 设置对象(session 或 application)的作用域。
id 为对象指定一个唯一的 id。
progid 与 classid 关联的 id。progid 的格式是:[vendor.]component[.version]。

progid 或 classid 必需被指定。

classid 为 com 类对象指定一个唯一的 id。

progid 或 classid 必需被指定。

实例

第一个实例通过使用 progid 参数创建了一个名为 "myad" 的 session 作用域对象:

<object runat="server" scope="session" id="myad" progid="mswc.adrotator">
</object>

第二个实例通过使用 classid 参数创建了一个名为 "myconnection" 的 application 作用域对象:

<object runat="server" scope="application" id="myconnection"
classid="clsid:8ad3067a-b3fc-11cf-a560-00a0c9081c21">
</object>

在 global.asa 文件中声明的对象可被应用程序中的任何脚本使用:

global.asa:

<object runat="server" scope="session" id="myad" progid="mswc.adrotator">
</object>

您可以从 asp 应用程序中的任意页面引用 "myad" 对象:

某个 .asp 文件:

<%=myad.getadvertisement("/banners/adrot.txt")%>

typelibrary 声明

typelibrary(类型库)是一个容器,其中装有对应于 com 对象的 dll 文件。通过在 global.asa 文件中包含对 typelibrary 的调用,可以访问 com 对象的常量,同时 asp 代码也能更好地报告错误。如果您的 web 应用程序依赖于已在类型库中声明的数据类型的 com 对象,您可以在 global.asa 中对类型库进行声明。

语法

<!--metadata type="typelib"
file="filename" uuid="id" version="number" lcid="localeid"
-->

参数 描述
file 规定指向类型库的绝对路径。

file 参数或者 uuid 参数,两者缺一不可。

uuid 规定了类型库的唯一的标识符。

file 参数或者 uuid 参数,两者缺一不可。

version 可选。用于选择版本。如果没有找到需要的版本,将使用最接近的版本。
lcid 可选。用于类型库的地区标识符。

错误值

服务器会返回以下的错误消息之一:

错误代码 描述
asp 0222 无效的类型库规范
asp 0223 没有找到类型库
asp 0224 无法加载类型库
asp 0225 无法包装类型库

注释:metadata 标签可出现在 global.asa 文件中的任何位置(在 <script> 标签的内外皆可)。然而,我们还是推荐将 metadata 标签放置于 global.asa 文件的顶部。

限定

关于可以在 global.asa 文件中引用的内容的限定:

  • 您无法显示 global.asa 文件中的文本。此文件无法显示信息。
  • 您只能在 application_onstart 和 application_onend 子例程中使用 server 和 application 对象。在 session_onend 子例程中,您可以使用 server、application 和 session 对象。在 session_onstart 子例程中,您可以使用任何内建的对象。

如何使用子例程

global.asa 常用于初始化变量。

下面的实例演示了如何检测访客首次到达 web 站点的确切时间。时间存储在名为 "started" 的 session 对象中,并且 "started" 变量的值可被应用程序中的任何 asp 页面访问:

<script language="vbscript" runat="server">
sub session_onstart
session("started")=now()
end sub
</script>

global.asa 也可用于控制页面访问。

下面的实例演示了如何把每个新的访客重定向到另一个页面,在这个例子中会定向到一个名为 "newpage.asp" 的页面:

<script language="vbscript" runat="server">
sub session_onstart
response.redirect("newpage.asp")
end sub
</script>

您可以在 global.asa 文件中包含函数。

在下面的实例中,当 web 服务器启动时,application_onstart 子例程也会启动。然后,application_onstart 子例程会调用另一个名为 "getcustomers" 的子例程。"getcustomers" 子例程会打开一个数据库,然后从 "customers" 表中取回一个记录集。此记录集会赋值给一个数组,在不查询数据库的情况下,任何 asp 页面都能够访问这个数组:

<script language="vbscript" runat="server">

sub application_onstart
getcustomers
end sub

sub getcustomers
set conn=server.createobject("adodb.connection")
conn.provider="microsoft.jet.oledb.4.0"
conn.open "c:/webdata/northwind.mdb"
set rs=conn.execute("select name from customers")
application("customers")=rs.getrows
rs.close
conn.close
end sub

</script>

global.asa 实例

在这个实例中,我们将创建一个计算当前访客数量的 global.asa 文件。

  • 当服务器启动时,application_onstart 设置 application 变量 "visitors" 的值为 0。
  • 每当有新的访客来访时,session_onstart 子例程就会给变量 "visitors" 加 1。
  • 每当 session_onend 子例程被触发时,该子例程就会从变量 "visitors" 减 1。

global.asa 文件:

<script language="vbscript" runat="server">

sub application_onstart
application("visitors")=0
end sub

sub session_onstart
application.lock
application("visitors")=application("visitors")+1
application.unlock
end sub

sub session_onend
application.lock
application("visitors")=application("visitors")-1
application.unlock
end sub

</script>

在 asp 文件中,显示当前访客的数量:

<!doctype html>
<html>
<head>
</head>
<body>
<p>there are <%response.write(application("visitors"))%> online now!</p>
</body>
</html>

相关文章