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>