ASP Référence rapide


Référence rapide ASP du tutoriel Example. Imprimez-la et gardez-la dans votre poche pour l'utiliser à tout moment.


Syntaxe de base

Les scripts ASP sont entourés par <% et %>. Pour écrire la sortie vers le navigateur :

<html>
<body>
<% response.write("Hello World!") %>
</body>
</html>

Le langage par défaut dans ASP est VBScript. Pour utiliser un autre langage de script, insérez une déclaration de langage au début de la page ASP :

<%@ language="javascript" %>
<html>
<body>

<%
....
%>

Formulaires et saisie utilisateur

Request.QueryString est utilisé pour collecter les valeurs d'un formulaire avec method="get". Les informations envoyées depuis un formulaire à l'aide de la méthode GET sont visibles par tous les utilisateurs (elles apparaissent dans la barre d'adresse du navigateur) et il y a des limites sur la quantité d'informations pouvant être envoyée.

Request.Form est utilisé pour collecter les valeurs d'un formulaire avec method="post". Les informations envoyées depuis un formulaire à l'aide de la méthode POST sont invisibles pour les utilisateurs et il n'y a aucune limite sur la quantité d'informations pouvant être envoyée.

Cookies ASP

Les cookies sont couramment utilisés pour identifier les utilisateurs. Un cookie est un petit fichier que le serveur dépose sur l'ordinateur de l'utilisateur. Chaque fois que le même ordinateur demande une page via un navigateur, il envoie le cookie.

La commande Response.Cookies est utilisée pour créer un cookie :

<%
Response.Cookies("firstname")="Alex"
Response.Cookies("firstname").Expires="May 10,2002"
%>

Remarque :La commande Response.Cookies doit apparaître avant la balise <html> !

La commande "Request.Cookies" est utilisée pour récupérer la valeur du cookie :

<%
fname=Request.Cookies("firstname")
response.write("Firstname=" & fname)
%>

Inclusion de fichiers

En utilisant la directive #include, vous pouvez insérer le contenu d'un autre fichier ASP dans un fichier ASP avant que le serveur ne l'exécute. La directive #include est utilisée pour créer des fonctions, des en-têtes, des pieds de page ou d'autres éléments qui doivent être réutilisés sur plusieurs pages.

Syntaxe :

<!--#include virtual="somefile.inc"-->
Or
<!--#include file ="somefile.inc"-->

Utilisez le mot-clé virtual pour indiquer un chemin qui commence par un répertoire virtuel. Si un fichier nommé "header.inc" se trouve dans le répertoire virtuel /html, la ligne de code suivante insérera le contenu du fichier "header.inc" :

<!-- #include virtual ="/html/header.inc" -->

Utilisez le mot-clé file pour indiquer un chemin relatif. Un chemin relatif commence par le répertoire qui contient le fichier de référence. Si vous avez un fichier dans le répertoire html, et que le fichier "header.inc" se trouve dans le répertoire html, la ligne de code suivante insérera le contenu du fichier "header.inc" dans votre fichier :

<!-- #include file ="headersheader.inc" -->

Utilisez le mot-clé file avec la syntaxe (..) pour référencer un fichier dans un répertoire de niveau supérieur.

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 d'une application ASP.

Remarque :Le fichier Global.asa doit être stocké dans le répertoire racine de l'application ASP, et chaque application ne peut avoir qu'un seul fichier Global.asa.

Le fichier Global.asa ne peut contenir que les éléments suivants :

  • Événements d'application
  • Événements de session
  • Déclarations <object>
  • Déclarations TypeLibrary
  • Directive #include

Événements d'application et de session

Dans Global.asa, vous pouvez indiquer aux objets application et session ce qu'il faut faire au démarrage de l'application/session et ce qu'il faut faire à la fin de l'application/session. Le code qui accomplit cette tâche est placé dans des gestionnaires d'événements.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 balises HTML <script> :

<script language="vbscript" runat="server">
sub Application_OnStart
' some code
end sub
sub Application_OnEnd
' some code
end sub
sub Session_OnStart
' some code
end sub
sub Session_OnEnd
' some code
end sub
</script>

Déclarations <object>

Les objets de portée session ou application peuvent être créés dans le fichier Global.asa à l'aide de 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>

Déclaration TypeLibrary

TypeLibrary (bibliothèque de types) est un conteneur qui contient des fichiers DLL correspondant à des objets COM. En incluant un appel à TypeLibrary dans le fichier Global.asa, vous pouvez accéder aux constantes des objets 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éjà 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="typelibraryuuid"
version="versionnumber"
lcid="localeid"
-->

Objet Session

L'objet Session est utilisé pour stocker des informations sur une session utilisateur, ou pour modifier les paramètres de session utilisateur. Les variables stockées dans l'objet Session stockent des informations sur un seul utilisateur et sont disponibles pour toutes les pages d'une application.

Collections

  • Contents - Contient tous les éléments ajoutés à la session via des commandes de script.
  • StaticObjects - Contient tous les objets ajoutés à la session à l'aide de la balise HTML <object>.
  • Contents.Remove(item/index) - Supprime un élément de la collection Contents.
  • Contents.RemoveAll() - Supprime tous les éléments de la collection Contents.

Propriétés

  • CodePage - Spécifie le jeu de caractères utilisé lors de l'affichage du contenu dynamique.
  • LCID - Définit l'identificateur de paramètres régionaux utilisé pour afficher le contenu dynamique.
  • SessionID - Renvoie l'ID de session.
  • Timeout - Définit ou renvoie le délai d'expiration de la session.

Méthodes

  • Abandon - Détruit tous les objets dans l'objet Session.

Objet Application

Un groupe de fichiers ASP qui fonctionnent ensemble pour accomplir une tâche est appelé une application. L'objet Application sert à lier ces fichiers entre eux. Tous les utilisateurs partagent un seul objet Application. L'objet Application stocke des informations qui seront utilisées par de nombreuses pages d'une application (comme les informations de connexion à une base de données).

Collections

  • Contents - Contient tous les éléments ajoutés à l'application via des commandes de script.
  • StaticObjects - Contient tous les objets ajoutés à l'application à l'aide de la balise HTML <object>.
  • Contents.Remove - Supprime un élément de la collection Contents.
  • Contents.RemoveAll - Supprime tous les éléments de la collection Contents.

Méthodes

  • Lock - Empêche les utilisateurs de modifier les propriétés de l'objet Application.
  • Unlock - Permet aux utilisateurs de modifier les propriétés de l'objet Application.

Objet Response

L'objet Response est utilisé pour envoyer la sortie du serveur à l'utilisateur.

Collections

  • Cookies(name) - Définit la valeur d'un cookie. Si le cookie n'existe pas, crée le cookie et définit la valeur spécifiée.

Propriétés

  • Buffer - Spécifie s'il faut mettre la sortie en mémoire tampon. Lorsque la sortie est mise en mémoire tampon, le serveur bloque la réponse au navigateur jusqu'à ce que tous les scripts serveur aient été traités, ou jusqu'à ce que le script appelle la méthode Flush ou End. Si vous voulez définir cette propriété, elle doit être placée avant la balise <html> dans le fichier ASP.
  • CacheControl - Définit si les serveurs proxy peuvent mettre en cache la sortie générée par ASP. Si elle est définie sur Public, les serveurs proxy mettront la page en cache.
  • Charset(charset_name) - Ajoute le nom du jeu de caractères (tel que "ISO8859-1") à l'en-tête content-type de l'objet Response.
  • ContentType - Définit le type de contenu HTTP de l'objet Response (tel que "text/html", "image/gif", "image/jpeg", "text/plain"). La valeur par défaut est "text/html".
  • Expires - Définit la durée de mise en cache du navigateur (en minutes) avant l'expiration de la page.
  • ExpiresAbsolute - Définit la date et l'heure d'expiration de la page mise en cache dans le navigateur.
  • IsClientConnected - Indique si le client s'est déconnecté du serveur.
  • Pics(pics_label) - Ajoute une valeur à la balise PICS dans l'en-tête de réponse.
  • Status - Spécifie la valeur de la ligne d'état renvoyée par le serveur.

Méthodes

  • AddHeader(name, value) - Ajoute un nouvel en-tête HTTP et sa valeur à la réponse HTTP.
  • AppendToLog string - Ajoute une chaîne à la fin de l'entrée du journal du serveur.
  • BinaryWrite(data_to_write) - Écrit des données directement dans la sortie sans aucune conversion de caractères.
  • Clear - Efface la sortie mise en mémoire tampon. Utilisez cette méthode pour gérer les erreurs. Si Response.Buffer n'est pas défini sur true, cette méthode génère une erreur d'exécution.
  • End - Arrête le traitement du script et renvoie le résultat actuel.
  • Flush - Envoie immédiatement la sortie mise en mémoire tampon. Si Response.Buffer n'est pas défini sur true, cette méthode génère une erreur d'exécution.
  • Redirect(url) - Redirige l'utilisateur vers une autre URL.
  • Write(data_to_write) - Écrit du texte à l'utilisateur.

Objet Request

Lorsque le navigateur demande une page au serveur, ce comportement est appelé une requête. L'objet Request est utilisé pour obtenir des informations auprès de l'utilisateur.

Collections

  • ClientCertificate - Contient toutes les valeurs de champ stockées dans le certificat client.
  • Cookies(name) - Contient toutes les valeurs de cookie envoyées dans la requête HTTP.
  • Form(element_name) - Contient toutes les valeurs de formulaire (saisie) envoyées par un formulaire en utilisant la méthode POST.
  • QueryString(variable_name) - Contient toutes les valeurs de variable dans la chaîne de requête HTTP.
  • ServerVariables(server_variable) - Contient toutes les valeurs des variables serveur.

Propriétés

  • TotalBytes - Renvoie le nombre total d'octets envoyés par le client dans le corps de la requête.

Méthodes

  • BinaryRead - Récupère les données envoyées du client au serveur dans le cadre d'une requête POST.

Objet Server

L'objet Server est utilisé pour accéder aux propriétés et méthodes sur le serveur.

Propriétés

  • ScriptTimeout - Définit ou renvoie la durée maximale, en secondes, pendant laquelle un script peut s'exécuter avant d'être interrompu.

Méthodes

  • CreateObject(type_of_object) - Crée une instance d'un objet.
  • Execute(path) - Exécute un autre fichier ASP à partir d'un fichier ASP. Une fois que le fichier ASP appelé a fini de s'exécuter, le contrôle revient au fichier ASP d'origine.
  • GetLastError() - Renvoie un objet ASPError qui décrit la condition d'erreur qui s'est produite.
  • HTMLEncode(string) - Applique un encodage HTML à une chaîne.
  • MapPath(path) - Mappe un chemin relatif ou virtuel vers un chemin physique.
  • Transfer(path) - Envoie toutes les informations d'état à un autre fichier pour traitement. Après le transfert, le contrôle du programme ne revient pas au fichier ASP d'origine.
  • URLEncode(string) - Applique les règles d'encodage URL à une chaîne.
Autres extensions