asp global.asa 文件
global.asa 文件
global.asa 文件是一個(gè)可選的文件,它可包含被 asp 應(yīng)用程序中每個(gè)頁面訪問的對(duì)象、變量和方法的聲明。
所有合法的瀏覽器腳本(javascript、vbscript、jscript、perlscript 等等)都能在 global.asa 中使用。
global.asa 文件只能包含下列內(nèi)容:
- application 事件
- session 事件
- <object> 聲明
- typelibrary 聲明
- #include 指令
注釋:global.asa 文件必須存放在 asp 應(yīng)用程序的根目錄中,而且每個(gè)應(yīng)用程序只能有一個(gè) global.asa 文件。
global.asa 中的事件
在 global.asa 中,您可以告訴 application 和 session 對(duì)象當(dāng) application/session 開始時(shí)做什么,當(dāng) application/session 結(jié)束時(shí)做什么。完成這項(xiàng)任務(wù)的代碼被放置在事件句柄中。global.asa 文件能包含四種類型的事件:
application_onstart - 此事件會(huì)在第一個(gè)用戶調(diào)用 asp 應(yīng)用程序的第一個(gè)頁面時(shí)發(fā)生。此事件會(huì)在 web 服務(wù)器重啟或者 global.asa 文件被編輯之后發(fā)生。"session_onstart" 事件會(huì)在此事件發(fā)生之后立即發(fā)生。session_onstart - 此事件會(huì)在每當(dāng)新用戶請(qǐng)求他(她)在 asp 應(yīng)用程序中的第一個(gè)頁面時(shí)發(fā)生。
session_onend - 此事件會(huì)在每當(dāng)用戶結(jié)束 session 時(shí)發(fā)生。在規(guī)定的時(shí)間(默認(rèn)的時(shí)間為 20 分鐘)內(nèi)如果用戶沒有請(qǐng)求任何頁面,用戶 session 就會(huì)結(jié)束。
application_onend - 此事件會(huì)在最后一個(gè)用戶結(jié)束其 session 之后發(fā)生。典型的情況是,此事件會(huì)在 web 服務(wù)器停止時(shí)發(fā)生。這個(gè)子程序用于在應(yīng)用程序停止后清除設(shè)置,比如刪除記錄或者向文本文件中寫入信息。
一個(gè) global.asa 文件可能如下所示:
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> 元素內(nèi)部。
<object> 聲明
可通過使用 <object> 標(biāo)簽在 global.asa 文件中創(chuàng)建帶有 session 或者 application 作用域的對(duì)象。
注釋:<object> 標(biāo)簽應(yīng)位于 <script> 標(biāo)簽外部!
語法
....
</object>
參數(shù) | 描述 |
---|---|
scope | 設(shè)置對(duì)象(session 或 application)的作用域。 |
id | 為對(duì)象指定一個(gè)唯一的 id。 |
progid | 與 classid 關(guān)聯(lián)的 id。progid 的格式是:[vendor.]component[.version]。
progid 或 classid 必需被指定。 |
classid | 為 com 類對(duì)象指定一個(gè)唯一的 id。 progid 或 classid 必需被指定。 |
實(shí)例
第一個(gè)實(shí)例通過使用 progid 參數(shù)創(chuàng)建了一個(gè)名為 "myad" 的 session 作用域?qū)ο螅?/p>
</object>
第二個(gè)實(shí)例通過使用 classid 參數(shù)創(chuàng)建了一個(gè)名為 "myconnection" 的 application 作用域?qū)ο螅?/p>
classid="clsid:8ad3067a-b3fc-11cf-a560-00a0c9081c21">
</object>
在 global.asa 文件中聲明的對(duì)象可被應(yīng)用程序中的任何腳本使用:
<object runat="server" scope="session" id="myad" progid="mswc.adrotator">
</object>
您可以從 asp 應(yīng)用程序中的任意頁面引用 "myad" 對(duì)象:
某個(gè) .asp 文件:
<%=myad.getadvertisement("/banners/adrot.txt")%>
typelibrary 聲明
typelibrary(類型庫)是一個(gè)容器,其中裝有對(duì)應(yīng)于 com 對(duì)象的 dll 文件。通過在 global.asa 文件中包含對(duì) typelibrary 的調(diào)用,可以訪問 com 對(duì)象的常量,同時(shí) asp 代碼也能更好地報(bào)告錯(cuò)誤。如果您的 web 應(yīng)用程序依賴于已在類型庫中聲明的數(shù)據(jù)類型的 com 對(duì)象,您可以在 global.asa 中對(duì)類型庫進(jìn)行聲明。
語法
file="filename" uuid="id" version="number" lcid="localeid"
-->
參數(shù) | 描述 |
---|---|
file | 規(guī)定指向類型庫的絕對(duì)路徑。
file 參數(shù)或者 uuid 參數(shù),兩者缺一不可。 |
uuid | 規(guī)定了類型庫的唯一的標(biāo)識(shí)符。
file 參數(shù)或者 uuid 參數(shù),兩者缺一不可。 |
version | 可選。用于選擇版本。如果沒有找到需要的版本,將使用最接近的版本。 |
lcid | 可選。用于類型庫的地區(qū)標(biāo)識(shí)符。 |
錯(cuò)誤值
服務(wù)器會(huì)返回以下的錯(cuò)誤消息之一:
錯(cuò)誤代碼 | 描述 |
---|---|
asp 0222 | 無效的類型庫規(guī)范 |
asp 0223 | 沒有找到類型庫 |
asp 0224 | 無法加載類型庫 |
asp 0225 | 無法包裝類型庫 |
注釋:metadata 標(biāo)簽可出現(xiàn)在 global.asa 文件中的任何位置(在 <script> 標(biāo)簽的內(nèi)外皆可)。然而,我們還是推薦將 metadata 標(biāo)簽放置于 global.asa 文件的頂部。
限定
關(guān)于可以在 global.asa 文件中引用的內(nèi)容的限定:
- 您無法顯示 global.asa 文件中的文本。此文件無法顯示信息。
- 您只能在 application_onstart 和 application_onend 子例程中使用 server 和 application 對(duì)象。在 session_onend 子例程中,您可以使用 server、application 和 session 對(duì)象。在 session_onstart 子例程中,您可以使用任何內(nèi)建的對(duì)象。
如何使用子例程
global.asa 常用于初始化變量。
下面的實(shí)例演示了如何檢測(cè)訪客首次到達(dá) web 站點(diǎn)的確切時(shí)間。時(shí)間存儲(chǔ)在名為 "started" 的 session 對(duì)象中,并且 "started" 變量的值可被應(yīng)用程序中的任何 asp 頁面訪問:
sub session_onstart
session("started")=now()
end sub
</script>
global.asa 也可用于控制頁面訪問。
下面的實(shí)例演示了如何把每個(gè)新的訪客重定向到另一個(gè)頁面,在這個(gè)例子中會(huì)定向到一個(gè)名為 "newpage.asp" 的頁面:
sub session_onstart
response.redirect("newpage.asp")
end sub
</script>
您可以在 global.asa 文件中包含函數(shù)。
在下面的實(shí)例中,當(dāng) web 服務(wù)器啟動(dòng)時(shí),application_onstart 子例程也會(huì)啟動(dòng)。然后,application_onstart 子例程會(huì)調(diào)用另一個(gè)名為 "getcustomers" 的子例程。"getcustomers" 子例程會(huì)打開一個(gè)數(shù)據(jù)庫,然后從 "customers" 表中取回一個(gè)記錄集。此記錄集會(huì)賦值給一個(gè)數(shù)組,在不查詢數(shù)據(jù)庫的情況下,任何 asp 頁面都能夠訪問這個(gè)數(shù)組:
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 實(shí)例
在這個(gè)實(shí)例中,我們將創(chuàng)建一個(gè)計(jì)算當(dāng)前訪客數(shù)量的 global.asa 文件。
- 當(dāng)服務(wù)器啟動(dòng)時(shí),application_onstart 設(shè)置 application 變量 "visitors" 的值為 0。
- 每當(dāng)有新的訪客來訪時(shí),session_onstart 子例程就會(huì)給變量 "visitors" 加 1。
- 每當(dāng) session_onend 子例程被觸發(fā)時(shí),該子例程就會(huì)從變量 "visitors" 減 1。
global.asa 文件:
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 文件中,顯示當(dāng)前訪客的數(shù)量:
<html>
<head>
</head>
<body>
<p>there are <%response.write(application("visitors"))%> online now!</p>
</body>
</html>