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 文件可能如下所示:
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>
參數 | 描述 |
---|---|
scope | 設置對象(session 或 application)的作用域。 |
id | 為對象指定一個唯一的 id。 |
progid | 與 classid 關聯的 id。progid 的格式是:[vendor.]component[.version]。
progid 或 classid 必需被指定。 |
classid | 為 com 類對象指定一個唯一的 id。 progid 或 classid 必需被指定。 |
實例
第一個實例通過使用 progid 參數創建了一個名為 "myad" 的 session 作用域對象:
</object>
第二個實例通過使用 classid 參數創建了一個名為 "myconnection" 的 application 作用域對象:
classid="clsid:8ad3067a-b3fc-11cf-a560-00a0c9081c21">
</object>
在 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 中對類型庫進行聲明。
語法
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 頁面訪問:
sub session_onstart
session("started")=now()
end sub
</script>
global.asa 也可用于控制頁面訪問。
下面的實例演示了如何把每個新的訪客重定向到另一個頁面,在這個例子中會定向到一個名為 "newpage.asp" 的頁面:
sub session_onstart
response.redirect("newpage.asp")
end sub
</script>
您可以在 global.asa 文件中包含函數。
在下面的實例中,當 web 服務器啟動時,application_onstart 子例程也會啟動。然后,application_onstart 子例程會調用另一個名為 "getcustomers" 的子例程。"getcustomers" 子例程會打開一個數據庫,然后從 "customers" 表中取回一個記錄集。此記錄集會賦值給一個數組,在不查詢數據庫的情況下,任何 asp 頁面都能夠訪問這個數組:
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 文件:
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 文件中,顯示當前訪客的數量:
<html>
<head>
</head>
<body>
<p>there are <%response.write(application("visitors"))%> online now!</p>
</body>
</html>