Utilisation des éléments intrinsèques ASP

Remonter à Création de pages Active Server - Présentation

Les objets intrinsèques ASP sont un ensemble d'objets COM fournis par ASP aux objets qui s'exécutent dans une page Active Server. Ils permettent à votre objet Active Server d'accéder aux informations reflétant les messages échangés entre votre application et le navigateur Web ainsi qu'un moyen de stocker des informations partagées par tous les objets Active Server appartenant à une même application ASP.

Pour simplifier l'accès à ces objets, la classe de base de votre objet Active Server les présente sous la forme de propriétés. Pour une description complète de ces objets, reportez-vous à la documentation Microsoft. Les rubriques suivantes vous en donnent une présentation rapide.

Application

On accède à l'objet Application via une interface IApplicationObject . Il représente toute l'application ASP, définie comme étant l'ensemble de tous les fichiers .asp d'un même répertoire virtuel et de ses sous-répertoires. L'objet Application peut être partagé par plusieurs clients, il propose donc une gestion du verrouillage que vous devez utiliser pour empêcher des conflits de threads.

IApplicationObject propose les membres suivants :

Membres de l'interface IApplicationObject : :

Propriété, méthode ou événement	Signification
Contents (propriété)	Enumère tous les objets ajoutés à l'application en utilisant les commandes de script. Cette interface a deux méthodes Remove et RemoveAll, que vous pouvez utiliser pour supprimer un objet de la liste ou bien tous les objets.
StaticObjects (propriété)	Enumère tous les objets ajoutés à l'application avec la balise <OBJECT>.
Lock (méthode)	Empêche d'autres clients de verrouiller l'objet Application jusqu'à l'appel de Unlock. Tous les clients doivent appeler Lock avant d'accéder à la mémoire partagée (par exemple, les propriétés).
Unlock (méthode)	Libère le verrou placé en utilisant la méthode Lock.
Application_OnEnd (événement)	Se produit à la sortie de l'application, après l'événement Session_OnEnd. Les seuls éléments intrinsèques alors disponibles sont Application et Server. Ce gestionnaire d'événement doit être écrit en VBScript ou en JScript.
Application_OnStart (événement)	Se produit avant la création d'une nouvelle session (avant Session_OnStart). Les seuls éléments intrinsèques alors disponibles sont Application et Server. Ce gestionnaire d'événement doit être écrit en VBScript ou en JScript.

Request

On accède à l'objet Request via une interface IRequest. Il donne des informations sur le message de requête HTTP qui a entraîné l'ouverture de la page Active Server.

IRequest propose les membres suivants :

Membres de l'interface IRequest : :

Propriété, méthode ou événement	Signification
ClientCertificate (propriété)	Indique la valeur de tous les champs du certificat client qui a été envoyé avec le message HTTP.
Cookies (propriété)	Indique la valeur de tous les en-têtes de cookie du message HTTP.
Form (propriété)	Indique la valeur des éléments de fiche dans le corps HTTP. Il est possible d'y accéder par nom.
QueryString (propriété)	Indique la valeur de toutes les variables de la chaîne de requête de l’en-tête HTTP.
ServerVariables (propriété)	Indique la valeur de diverses variables d'environnement. Ces variables représentent la plupart des variables courantes d'un en-tête HTTP.
TotalBytes (propriété)	Indique le nombre d'octets dans le corps de la requête. C'est la limite supérieure du nombre d'octets renvoyés par la méthode BinaryRead.
BinaryRead (méthode)	Récupère le contenu d'un message Post. Appelez la méthode en spécifiant le nombre maximum d'octets à lire. Le contenu résultant est renvoyé dans un tableau Variant d'octets. Après avoir appelé BinaryRead vous ne pouvez plus utiliser la propriété Form.

Response

On accède à l'objet Request via une interface IResponse. Il vous permet de spécifier des informations sur le message de réponse HTTP renvoyé au navigateur client.

IResponse propose les membres suivants :

Membres de l'interface IResponse  :

Propriété, méthode ou événement	Signification
Cookies (propriété)	Détermine la valeur des tous les en-têtes de cookie du message HTTP.
Buffer (propriété)	Indique si la sortie de la page est placée dans un tampon. Si c’est le cas, le serveur n’envoie la réponse au client qu’après avoir traité tous les scripts serveur de la page en cours.
CacheControl (propriété)	Détermine si des serveurs proxy peuvent placer dans un cache la sortie de la réponse.
Charset (propriété)	Ajoute le nom du jeu de caractères à l’en-tête de type de contenu.
ContentType (propriété)	Spécifie le type de contenu HTTP du corps du message de réponse.
Expires (propriété)	Spécifie combien de temps la réponse peut rester dans le cache d’un navigateur avant d’expirer.
ExpiresAbsolute (propriété)	Spécifie l’heure et la date d’expiration de la réponse.
IsClientConnected (propriété)	Indique si le client n’est plus connecté au serveur.
Pics (propriété)	Définit la valeur du champ pics-label de l’en-tête de réponse.
Status (propriété)	Indique l'état de la réponse. C'est la valeur d'un en-tête de status HTTP.
AddHeader (méthode)	Ajoute un en-tête HTTP de nom et de valeur spécifiés.
AppendToLog (méthode)	Ajoute une chaîne à la fin de l’entrée de l’historique du serveur Web pour cette requête.
BinaryWrite (méthode)	Ecrit des informations brutes (non interprétées) dans le corps du message de réponse.
Clear (méthode)	Efface tout le HTML placé dans le tampon.
End (méthode)	Arrête le traitement du fichier .asp et renvoie le résultat en cours.
Flush (méthode)	Envoie immédiatement tout ce que contient le tampon de sortie.
Redirect (méthode)	Envoie un message de réponse de redirection qui renvoie le navigateur client sur une autre URL.
Write (méthode)	Ecrit, sous forme de chaîne, une variable dans la sortie HTTP en cours.

Session

On accède à l'objet Session via une interface ISessionObject. Il vous permet de stocker des variables qui subsistent durant toute l'interaction d'un client avec l'application ASP. Ces variables ne sont donc pas libérées quand le client passe d'une page à une autre dans l'application ASP mais uniquement quand le client sort de l'application.

ISessionObject propose les membres suivants :

ISessionObject interface members :

Propriété, méthode ou événement	Signification
Contents (propriété)	Enumère tous les objets ajoutés à la session avec la balise <OBJECT>. Vous pouvez accéder à toute variable de la liste par son nom ou appeler les méthodesRemove ou RemoveAll de l'objet Contents pour supprimer des valeurs.
StaticObjects (propriété)	Enumère tous les objets ajoutés à la session avec la balise <OBJECT>.
CodePage (propriété)	Spécifie le code de page à utiliser pour mettre en correspondance les symboles. Différentes localisations peuvent utiliser des pages de code différentes.
LCID (propriété)	Spécifie l’identificateur de localisation à utiliser pour interpréter des contenus chaîne.
SessionID (propriété)	Indique l’identificateur de session du client en cours.
TimeOut (propriété)	Spécifie la durée (en minutes) durant laquelle la session subsiste sans une requête (ou une réactualisation) du client avant la fin de l’application.
Abandon (méthode)	Détruit la session et libère ses ressources.
Session_OnEnd (événement)	Se produit lors de l'abandon ou du dépassement de délai d'une session. Les seuls éléments intrinsèques alors disponibles sont Application, Server et Session. Ce gestionnaire d'événement doit être écrit en VBScript ou en JScript.
Session_OnStart (événement)	Se produit lors de la création par le serveur d'une nouvelle session (après Application_OnStart mais avant l'exécution du script de la page Active Server). Tous les éléments intrinsèques sont alors disponibles. Ce gestionnaire d'événement doit être écrit en VBScript ou en JScript.

Server

On accède à l'objet Server via une interface IServer. Il propose divers utilitaires pour écrire votre application ASP.

IServer propose les membres suivants :

Membres de l'interface IServer : :

Propriété, méthode ou événement	Signification
ScriptTimeout (propriété)	Identique à la propriété Timeout de l’objet Session.
CreateObject (méthode)	Instancie l’objet Active Server spécifié.
Execute (méthode)	Exécute le script d’un fichier .asp spécifié.
GetLastError (méthode)	Renvoie un objet ASPError qui décrit la condition d’erreur.
HTMLEncode (méthode)	Code une chaîne en vue de son utilisation dans un en-tête HTML, en remplaçant les caractères réservés par les constantes symboliques appropriées.
MapPath (méthode)	Associe un répertoire virtuel spécifié (un répertoire absolu dans le serveur en cours ou un chemin relatif à la page en cours) à un chemin d’accès physique.
Transfer (méthode)	Envoie toutes les informations d’état en cours �� une autre page Active Server pour traitement.
URLEncode (méthode)	Applique les règles de codage d’une URL, y compris les caractères d’échappement, à la chaîne spécifiée.

Voir aussi

• Création d'ASP pour des serveurs en et hors processus
• Définition de l'interface d'un objet COM