![]()
|
||||||||||||||||||||||||||||||||||||||
|
dernière mise à jour le
27/08/2006 |
Les objets ASP 3.0PrésentationComme 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 Ces différents objets ont différents domaines d'intervention. Cela peut se représenter de la façon suivante : ![]() L'objet
|
|||||||||||||||||||||||||||||||||||||
| propriétés | collections | méthodes |
|---|---|---|
TotalBytes
|
ClientCertificateCookiesFormQueryStringServerVariables
|
BinaryRead
|
ResponseL'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 |
|---|---|---|
BufferCacheControlCharsetContentTypeExpiresExpiresAbsoluteIsClientConnectedPICSStatus
|
Cookies
|
AddHeaderAppendToLogBinaryWriteClearEndFlushRedirectWrite
|
ObjectContextL'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 |
|---|---|
SetAbortSetComplete
|
OnTransactionAbortOnTransactionCommit
|
ApplicationL'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 |
|---|---|---|
ContentsStaticObjects
|
Contents.RemoveContents.RemoveAllLockUnlock
|
OnEndOnStart
|
SessionL'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 |
|---|---|---|---|
CodePageLCIDSessionIDTimeout
|
ContentsStaticObjects |
AbandonContents.RemoveContents.RemoveAll
|
OnEndOnStart
|
ServerL'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
|
CreateObjectExecuteGetLastErrorHTMLEncodeMapPathTransferURLEncode
|
ASPErrorL'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 |
|---|
ASPCodeASPDescriptionCategoryColumnDescriptionFileLineNumberSource
|