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 :

<script language="vbscript" runat="server">

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 runat="server" scope="scope" id="id" {progid="progID"|classid="classID"}>
....
</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 runat="server" scope="session" id="MyAd" progid="MSWC.AdRotator">
</object>

Le deuxième exemple crée un objet de portée application nommé "MyConnection" à l'aide du paramètre ClassID :

<object runat="server" scope="application" id="MyConnection"
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 :

GLOBAL.ASA :

<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

<!--METADATA TYPE="TypeLib"
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 :

<script language="vbscript" runat="server">
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" :

<script language="vbscript" runat="server">
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 :

<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>


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 :

<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>

Dans un fichier ASP, afficher le nombre actuel de visiteurs :

<!DOCTYPE html>
<html>
<head>
</head>
<body>
<p>Il y a <%response.write(Application("visitors"))%> en ligne maintenant !</p>
</body>
</html>

Autres extensions