The manual Page
English version
accueil | glossaire | downloads | liens ]
 

Les objets ASP 3.0

Présentation

Comme nous l'avons vu en introduction, ASP 3.0 utilise différents objets pour décrire les interactions client/serveur Web. Ces objets en ASP 3.0 sont au nombre de 7 :

Ces objets peuvent être constitués de 3 éléments : des propriétés, des méthodes et des collections. Une collection est un tableau associatif (tableau pouvant être indexé par autre chose que des entiers, comme des chaînes de caractères). ASP va par exemple utiliser une collection spéciale de l'objet Request (Request.Form) pour rassembler le contenu d'un formulaire par champ. On accède à ces 3 éléments en utilisant la notation objet en vigueur dans le language qu'on utilise pour écrire le code ASP de la page (généralement objet.element).

Ces différents objets ont différents domaines d'intervention. Cela peut se représenter de la façon suivante :

Les objets ASP 3.0

L'objet Request

L'objet Request représente la requête que fait le navigateur auprès du serveur pour récupérer la page ASP. Il rassemble dans différentes collections le message HTTP que le client a envoyé au serveur. Par exemple, cet objet contiendra dans une collection spéciale le contenu du formulaire que l'on aura envoyé.

Cet objet ne comporte qu'une propriété et une méthode. La partie la plus importante de cet objet sont ses 5 collections :

propriétés collections méthodes
TotalBytes ClientCertificate
Cookies
Form
QueryString
ServerVariables
BinaryRead

L'objet Response

L'objet Response sert à représenter la réponse HTTP du serveur à la requête du client. Ce sont d'une part les entêtes de la réponse (les statuts HTTP par exemple), et le corps de la réponse (la partie de la réponse contenant les données intéressantes) d'autre part. C'est cet objet qui permet d'écrire dynamiquement du code HTML à partir du code ASP avec notamment la méthode Write.

Cet objet possède beaucoup plus de méthodes et de propriétés que l'objet Request, mais n'a qu'une seule collection :

propriétés collections méthodes
Buffer
CacheControl
Charset
ContentType
Expires
ExpiresAbsolute
IsClientConnected
PICS
Status
Cookies AddHeader
AppendToLog
BinaryWrite
Clear
End
Flush
Redirect
Write

L'objet ObjectContext

L'objet ObjectContext sert à contrôler les transactions ASP gérées par le serveur de transaction Microsoft (MTS, Microsoft Transaction Server).

Il est nécessaire de faire figurer la directive @Transaction sur la première ligne du script ASP pour utiliser cet objet. Lorsque cette directive est utilisée, la page ASP démarre une transaction et ne s'arrête que lorsque la transaction a soit réussi, soit échoué.

L'objet ObjectContext ne possède que 2 méthodes pour "forcer" la validation ou l'annulation de la transaction. 2 événements permettent d'implémenter des comportements spécifiques (procédures définies dans le script courant) lorsque la transaction réussi ou échoue.

méthodes événements
SetAbort
SetComplete
OnTransactionAbort
OnTransactionCommit

L'objet Application

L'objet Application représente l'application Web au sens large. C'est un gros container qui contient des données dynamiques valables pour tous les visiteurs du site à tout instant (le nombre de visiteurs en cours par exemple). Pour schématiser, l'objet Application contient les variables globales de l'application.

L'objet Application peut fonctionner comme une collection : on peut ajouter dynamiquement des éléments de l'une des deux façons suivantes :

Application("nom") = "toto" ' valeur scalaire
Set Application("connexion") = Server.CreateObject("ADODB.Connection") ' objet

Les éléments ainsi ajoutés peuvent être accédés en utilisant la même notation que ci-dessus ou en utilisant la collection Application.Contents. La collection Application.StaticObjects permet d'accéder aux objets créés avec les balises HTML <OBJECT> pour lesquelles l'aatribut scope vaut "Application".

Deux événements OnEnd et OnStart permettent d'exécuter des actions (comme par exemple initialiser des variables) au moment du démarrage ou de l'arrêt de l'application.

collections méthodes événements
Contents
StaticObjects
Contents.Remove
Contents.RemoveAll
Lock
Unlock
OnEnd
OnStart

L'objet Session

L'objet Session est utilisé pour gérer les sessions utilisateur en ASP. Une session est un environnement propre à chaque visiteur ou utilisateur du site ; cela permet de stocker des informations spécifiques au visiteur, comme par exemple le nombre de fois où il est venu sur le site, la liste des articles qu'il est en train de commander sur un site marchand, etc. Ces informations sont valables pour une durée déterminée (qui peut être infinie). Par défaut, les sessions expirent au bout de 20 minutes.

Tout comme l'objet Application, l'objet Session peut fonctionner comme une collection : on peut ajouter dynamiquement des éléments de l'une des deux façons suivantes :

Session("nom") = "toto" ' valeur scalaire
Set Session("connexion") = Server.CreateObject("ADODB.Connection") ' objet

Les éléments ainsi ajoutés peuvent être accédés en utilisant la même notation que ci-dessus ou en utilisant la collection Session.Contents. La collection Session.StaticObjects permet d'accéder aux objets créés avec les balises HTML <OBJECT> pour lesquelles l'aatribut scope vaut "Session".

Mais l'affinité avec l'objet Application ne s'arrête pas là : ces 2 objets ont en effet 2 méthodes, leurs collections et leurs événements en commun. L'objet Session contient en plus 4 propriétés, qui sont comme des variables de session ayant une signification au niveau système (par exemple, l'expiration d'une session est gérée de manière automatique par le serveur Web).

propriétés collections méthodes événements
CodePage
LCID
SessionID
Timeout
Contents
StaticObjects
Abandon
Contents.Remove
Contents.RemoveAll
OnEnd
OnStart

L'objet Server

L'objet Server représente le serveur Web et le moteur ASP. Cet objet permet de gérer (sans toutefois administrer e serveur) quelques paramètres du serveur Web et instancier les objets de l'utilisateur.

Cet objet ne possède aucune collection ; il n'a qu'une seule propriété :

propriétés méthodes
ScriptTimeout CreateObject
Execute
GetLastError
HTMLEncode
MapPath
Transfer
URLEncode

L'objet ASPError

L'objet ASPError permet de recueillir des informations sur les erreurs survenues lors de l'exécution du code ASP de la page.

On répère un objet ASPError en utilisant la méthode Server.GetLastError.

Un objet ASPError possède 9 propriétés en lecture seule :

propriétés
ASPCode
ASPDescription
Category
Column
Description
File
Line
Number
Source

format imprimable format imprimable



Copyright © 2000-2006 themanualpage.org - Ce site est soumis aux conditions décrites dans les licences GNU GPL et FDL.