ASP Global.asa-Datei
Global.asa-Datei
Die Global.asa-Datei ist eine optionale Datei, die Deklarationen von Objekten, Variablen und Methoden enthalten kann, auf die von jeder Seite in der ASP-Anwendung zugegriffen werden kann.
Alle gültigen Browserskripte (JavaScript, VBScript, JScript, PerlScript usw.) können in Global.asa verwendet werden.
Die Datei Global.asa kann nur Folgendes enthalten:
- Application-Ereignisse
- Session-Ereignisse
- <object>-Deklarationen
- TypeLibrary-Deklarationen
- #include-Direktiven
Hinweis:Die Datei Global.asa muss im Stammverzeichnis der ASP-Anwendung gespeichert werden, und jede Anwendung kann nur eine Global.asa-Datei haben.
Ereignisse in Global.asa
In Global.asa können Sie den Anwendungs- und Sitzungsobjekten mitteilen, was beim Starten der Anwendung/Sitzung und beim Beenden der Anwendung/Sitzung zu tun ist. Der Code, der diese Aufgabe ausführt, wird in Ereignishandlern platziert. Die Datei Global.asa kann vier Arten von Ereignissen enthalten:
Application_OnStart- Dieses Ereignis tritt auf, wenn der erste Benutzer die erste Seite einer ASP-Anwendung aufruft. Dieses Ereignis tritt auf, nachdem der Webserver neu gestartet oder die Datei Global.asa bearbeitet wurde. Das Ereignis „Session_OnStart“ tritt unmittelbar nach diesem Ereignis auf.Session_OnStart- Dieses Ereignis tritt immer dann auf, wenn ein neuer Benutzer seine erste Seite in der ASP-Anwendung anfordert.
Session_OnEnd- Dieses Ereignis tritt immer dann auf, wenn ein Benutzer eine Sitzung beendet. Wenn der Benutzer innerhalb einer bestimmten Zeit (die Standardzeit beträgt 20 Minuten) keine Seiten anfordert, wird die Sitzung des Benutzers beendet.
Application_OnEnd- Dieses Ereignis tritt auf, nachdem der letzte Benutzer seine Sitzung beendet hat. Typischerweise tritt dieses Ereignis auf, wenn der Webserver gestoppt wird. Diese Subroutine wird verwendet, um Einstellungen nach dem Stoppen der Anwendung zu bereinigen, wie z. B. das Löschen von Datensätzen oder das Schreiben von Informationen in eine Textdatei.
Eine Global.asa-Datei kann wie folgt aussehen:
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>
Hinweis:Da wir keine ASP-Skriptbegrenzer (<% und %>) verwenden können, um Skripte in die Global.asa-Datei einzufügen, müssen wir die Subroutinen innerhalb des HTML-<script>-Elements platzieren.
<object>-Deklaration
Objekte mit Sitzungs- oder Anwendungsskalierung können in der Global.asa-Datei über das Tag <object> erstellt werden.
Hinweis:Das <object>-Tag sollte außerhalb des <script>-Tags platziert werden!
Syntax
....
</object>
| Parameters | Beschreibung |
|---|---|
| scope | Legt den Gültigkeitsbereich des Objekts fest (Session oder Application). |
| id | Gibt eine eindeutige ID für das Objekt an. |
| ProgID | Die mit ClassID verknüpfte ID. Das Format von ProgID ist: [Vendor.]Component[.Version]. Entweder ProgID oder ClassID muss angegeben werden. |
| ClassID | Gibt eine eindeutige ID für ein COM-Klassenobjekt an. Entweder ProgID oder ClassID muss angegeben werden. |
Beispiele
Das erste Beispiel erstellt ein objektbasiertes Sitzungsobjekt mit dem Namen „MyAd“ unter Verwendung des Parameters ProgID:
</object>
Das zweite Beispiel erstellt ein anwendungsorientiertes Objekt mit dem Namen „MyConnection“ unter Verwendung des Parameters ClassID:
classid="Clsid:8AD3067A-B3FC-11CF-A560-00A0C9081C21">
</object>
In der Datei Global.asa deklarierte Objekte können von jedem Skript in der Anwendung verwendet werden:
<object runat="server" scope="session" id="MyAd" progid="MSWC.AdRotator">
</object>
Sie können von jeder Seite in einer ASP-Anwendung aus auf das Objekt „MyAd“ verweisen:
Eine bestimmte .ASP-Datei:
<%=MyAd.GetAdvertisement("/banners/adrot.txt")%>
TypeLibrary-Deklaration
Eine TypeLibrary ist ein Container, der DLL-Dateien enthält, die COM-Objekten entsprechen. Durch das Einbinden eines Aufrufs der TypeLibrary in die Global.asa-Datei können Sie auf die Konstanten des COM-Objekts zugreifen, und ASP-Code kann Fehler auch besser melden. Wenn Ihre Webanwendung von COM-Objekten abhängt, deren Datentypen in einer Typbibliothek deklariert sind, können Sie die Typbibliothek in Global.asa deklarieren.
Syntax
file="filename" uuid="id" version="number" lcid="localeid"
-->
| Parameters | Beschreibung |
|---|---|
| Datei | Gibt den absoluten Pfad zur Typbibliothek an. Entweder der file-Parameter oder der uuid-Parameter ist erforderlich; einer von beiden muss angegeben werden. |
| uuid | Gibt den eindeutigen Bezeichner der Typbibliothek an. Entweder der file-Parameter oder der uuid-Parameter ist erforderlich; einer von beiden muss angegeben werden. |
| version | Optional. Wird verwendet, um eine Version auszuwählen. Wenn die gewünschte Version nicht gefunden wird, wird die nächstgelegene Version verwendet. |
| lcid | Optional. Wird für den Gebietsschemabezeichner der Typbibliothek verwendet. |
Fehlerwerte
Der Server gibt eine der folgenden Fehlermeldungen zurück:
| Fehlercode | Beschreibung |
|---|---|
| ASP 0222 | Ungültige Typbibliotheksspezifikation |
| ASP 0223 | Typbibliothek nicht gefunden |
| ASP 0224 | Typbibliothek konnte nicht geladen werden |
| ASP 0225 | Typbibliothek konnte nicht umschlossen werden |
Hinweise:Das METADATA-Tag kann überall in der Global.asa-Datei (entweder innerhalb oder außerhalb der <script>-Tags) platziert werden. Wir empfehlen jedoch dennoch, das METADATA-Tag am Anfang der Global.asa-Datei zu platzieren.
Einschränkungen
Einschränkungen bezüglich dessen, worauf in der Global.asa-Datei verwiesen werden kann:
- Sie können keinen Text aus der Global.asa-Datei anzeigen. Diese Datei kann keine Informationen anzeigen.
- Sie können nur die Objekte Server und Application in den Unterprogrammen Application_OnStart und Application_OnEnd verwenden. Im Unterprogramm Session_OnEnd können Sie die Objekte Server, Application und Session verwenden. Im Unterprogramm Session_OnStart können Sie alle integrierten Objekte verwenden.
Verwendung von Unterprogrammen
Global.asa wird oft verwendet, um Variablen zu initialisieren.
Das folgende Beispiel zeigt, wie man die genaue Uhrzeit ermittelt, zu der ein Besucher das erste Mal auf der Website ankommt. Die Uhrzeit wird in einem Session-Objekt namens "started" gespeichert, und auf den Wert der "started"-Variablen kann von jeder ASP-Seite in der Anwendung aus zugegriffen werden:
sub Session_OnStart
Session("started")=now()
end sub
</script>
Global.asa kann auch verwendet werden, um den Seitenzugriff zu steuern.
Das folgende Beispiel zeigt, wie jeder neue Besucher auf eine andere Seite umgeleitet wird; in diesem Beispiel werden sie zu einer Seite namens "newpage.asp" umgeleitet:
sub Session_OnStart
Response.Redirect("newpage.asp")
end sub
</script>
Sie können Funktionen in die Global.asa-Datei einbinden.
Im folgenden Beispiel startet die Subroutine Application_OnStart, wenn der Webserver startet. Dann ruft die Subroutine Application_OnStart eine andere Subroutine namens "getcustomers" auf. Die Subroutine "getcustomers" öffnet eine Datenbank und ruft ein Recordset aus der Tabelle "customers" ab. Dieses Recordset wird einem Array zugewiesen, und jede ASP-Seite kann auf dieses Array zugreifen, ohne die Datenbank abzufragen:
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-Beispiel
In diesem Beispiel erstellen wir eine Global.asa-Datei, die die aktuelle Anzahl der Besucher zählt.
- Wenn der Server startet, setzt Application_OnStart den Wert der Application-Variablen "visitors" auf 0.
- Wann immer ein neuer Besucher eintrifft, inkrementiert die Subroutine Session_OnStart die Variable "visitors" um 1.
- Wann immer die Subroutine Session_OnEnd ausgelöst wird, dekrementiert sie die Variable "visitors" um 1.
Global.asa-Datei:
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>
In einer ASP-Datei die aktuelle Anzahl der Besucher anzeigen:
<html>
<head>
</head>
<body>
<p>Es sind <%response.write(Application("visitors"))%> jetzt online!</p>
</body>
</html>
Andere Erweiterungen