ASP Fichier Global.asa
Fichier Global.asa
Le fichier Global.asa est un fichier facultatif qui peut contenir des déclarations d'objets, de variables et de méthodes accessibles par chaque page de l'application ASP.
Tous les scripts de navigateur valides (JavaScript, VBScript, JScript, PerlScript, etc.) peuvent être utilisés dans Global.asa.
Le fichier Global.asa ne peut contenir que les éléments suivants :
- Événements Application
- Événements Session
- déclarations <object>
- déclarations TypeLibrary
- directives #include
Remarque :Le fichier Global.asa doit se trouver dans le répertoire racine de l'application ASP, et chaque application ne peut avoir qu'un seul fichier Global.asa.
Événements dans Global.asa
Dans Global.asa, vous pouvez indiquer aux objets application et session ce qu'ils doivent faire lorsque l'application/session démarre, et ce qu'ils doivent faire lorsque l'application/session se termine. Le code qui accomplit cette tâche est placé dans des gestionnaires d'événements. Le fichier Global.asa peut contenir quatre types d'événements :
Application_OnStart- Cet événement se produit lorsque le premier utilisateur appelle la première page d'une application ASP. Cet événement se produit après le redémarrage du serveur Web ou la modification du fichier Global.asa. L'événement « Session_OnStart » se produit immédiatement après cet événement.Session_OnStart- Cet événement se produit chaque fois qu'un nouvel utilisateur demande sa première page dans l'application ASP.
Session_OnEnd- Cet événement se produit chaque fois qu'un utilisateur termine une session. Si l'utilisateur ne demande aucune page dans un délai spécifié (le délai par défaut est de 20 minutes), sa session se terminera.
Application_OnEnd- Cet événement se produit après que le dernier utilisateur a terminé sa session. Généralement, cet événement se produit lorsque le serveur Web est arrêté. Cette sous-routine est utilisée pour nettoyer les paramètres après l'arrêt de l'application, comme la suppression d'enregistrements ou l'écriture d'informations dans un fichier texte.
Un fichier Global.asa peut ressembler à ceci :
sub Application_OnStart
'du code
end sub
sub Application_OnEnd
'du code
end sub
sub Session_OnStart
'du code
end sub
sub Session_OnEnd
'du code
end sub
</script>
Remarque :Comme nous ne pouvons pas utiliser les délimiteurs de script ASP (<% et %>) pour insérer des scripts dans le fichier Global.asa, nous devons placer les sous-routines à l'intérieur de l'élément HTML <script>.
Déclaration de <object>
Les objets avec une portée session ou application peuvent être créés dans le fichier Global.asa en utilisant la balise <object>.
Remarque :La balise <object> doit être placée en dehors de la balise <script> !
Syntaxe
....
</object>
| Parameters | Description |
|---|---|
| scope | Définit la portée de l'objet (Session ou Application). |
| id | Spécifie un identifiant unique pour l'objet. |
| ProgID | L'identifiant associé à ClassID. Le format de ProgID est : [Vendor.]Component[.Version]. ProgID ou ClassID doit être spécifié. |
| ClassID | Spécifie un identifiant unique pour un objet de classe COM. ProgID ou ClassID doit être spécifié. |
Exemples
Le premier exemple crée un objet de portée session nommé "MyAd" à l'aide du paramètre ProgID :
</object>
Le deuxième exemple crée un objet de portée application nommé "MyConnection" à l'aide du paramètre ClassID :
classid="Clsid:8AD3067A-B3FC-11CF-A560-00A0C9081C21">
</object>
Les objets déclarés dans le fichier Global.asa peuvent être utilisés par n'importe quel script de l'application :
<object runat="server" scope="session" id="MyAd" progid="MSWC.AdRotator">
</object>
Vous pouvez référencer l'objet "MyAd" depuis n'importe quelle page d'une application ASP :
Un certain fichier .ASP :
<%=MyAd.GetAdvertisement("/banners/adrot.txt")%>
Déclaration TypeLibrary
Une TypeLibrary est un conteneur qui contient les fichiers DLL correspondant aux objets COM. En incluant un appel à TypeLibrary dans le fichier Global.asa, vous pouvez accéder aux constantes de l'objet COM, et le code ASP peut également mieux signaler les erreurs. Si votre application Web dépend d'objets COM dont les types de données sont déclarés dans une bibliothèque de types, vous pouvez déclarer la bibliothèque de types dans Global.asa.
Syntaxe
file="filename" uuid="id" version="number" lcid="localeid"
-->
| Parameters | Description |
|---|---|
| fichier | Spécifie le chemin absolu de la bibliothèque de types. Le paramètre file ou le paramètre uuid est requis ; l'un des deux doit être présent. |
| uuid | Spécifie l'identifiant unique de la bibliothèque de types. Le paramètre file ou le paramètre uuid est requis ; l'un des deux doit être présent. |
| version | Facultatif. Utilisé pour sélectionner une version. Si la version requise est introuvable, la version la plus proche sera utilisée. |
| lcid | Facultatif. Utilisé pour l'identificateur de paramètres régionaux de la bibliothèque de types. |
Valeurs d'erreur
Le serveur renverra l'un des messages d'erreur suivants :
| Code d'erreur | Description |
|---|---|
| ASP 0222 | Spécification de bibliothèque de types non valide |
| ASP 0223 | Bibliothèque de types introuvable |
| ASP 0224 | Impossible de charger la bibliothèque de types |
| ASP 0225 | Impossible d'encapsuler la bibliothèque de types |
Remarques :La balise METADATA peut apparaître n'importe où dans le fichier Global.asa (que ce soit à l'intérieur ou à l'extérieur des balises <script>). Toutefois, nous recommandons toujours de placer la balise METADATA en haut du fichier Global.asa.
Restrictions
Limitations concernant ce qui peut être référencé dans le fichier Global.asa :
- Vous ne pouvez pas afficher de texte depuis le fichier Global.asa. Ce fichier ne peut pas afficher d'informations.
- Vous pouvez uniquement utiliser les objets Server et Application dans les sous-programmes Application_OnStart et Application_OnEnd. Dans le sous-programme Session_OnEnd, vous pouvez utiliser les objets Server, Application et Session. Dans le sous-programme Session_OnStart, vous pouvez utiliser n'importe quels objets intégrés.
Comment utiliser les sous-programmes
Global.asa est souvent utilisé pour initialiser des variables.
L'exemple suivant montre comment détecter l'heure exacte à laquelle un visiteur arrive pour la première fois sur le site Web. L'heure est stockée dans un objet Session nommé "started", et la valeur de la variable "started" peut être consultée par n'importe quelle page ASP de l'application :
sub Session_OnStart
Session("started")=now()
end sub
</script>
Global.asa peut également être utilisé pour contrôler l'accès aux pages.
L'exemple suivant montre comment rediriger chaque nouveau visiteur vers une autre page ; dans cet exemple, ils sont redirigés vers une page nommée "newpage.asp" :
sub Session_OnStart
Response.Redirect("newpage.asp")
end sub
</script>
Vous pouvez inclure des fonctions dans le fichier Global.asa.
Dans l'exemple suivant, lorsque le serveur Web démarre, le sous-programme Application_OnStart démarre également. Ensuite, le sous-programme Application_OnStart appelle un autre sous-programme nommé "getcustomers". Le sous-programme "getcustomers" ouvre une base de données et récupère un recordset de la table "customers". Ce recordset est affecté à un tableau, et n'importe quelle page ASP peut accéder à ce tableau sans interroger la base de données :
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>
Exemple Global.asa
Dans cet exemple, nous allons créer un fichier Global.asa qui compte le nombre actuel de visiteurs.
- Lorsque le serveur démarre, Application_OnStart définit la valeur de la variable Application "visitors" à 0.
- Chaque fois qu'un nouveau visiteur arrive, la sous-routine Session_OnStart incrémente la variable "visitors" de 1.
- Chaque fois que la sous-routine Session_OnEnd est déclenchée, elle décrémente la variable "visitors" de 1.
Fichier 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>
Dans un fichier ASP, afficher le nombre actuel de visiteurs :
<html>
<head>
</head>
<body>
<p>Il y a <%response.write(Application("visitors"))%> en ligne maintenant !</p>
</body>
</html>
Autres extensions