Référence rapide ASP


Référence rapide ASP de W3Schools. Imprimez-le et pliez-le dans votre poche.


Syntaxe de base

Les scripts ASP sont entourés de <% et %>. Pour écrire une sortie dans un 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 spécification de langage en haut de la page ASP :

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

<%
....
%>


Formulaires et entrée de l'utilisateur

Request.QueryString est utilisé pour collecter des valeurs dans un formulaire avec method="get". Les informations envoyées à partir d'un formulaire avec la méthode GET sont visibles par tous (elles seront affichées dans la barre d'adresse du navigateur) et ont des limites sur la quantité d'informations à envoyer.

Request.Form est utilisé pour collecter des valeurs dans un formulaire avec method="post". Les informations envoyées à partir d'un formulaire avec la méthode POST sont invisibles pour les autres et n'ont aucune limite sur la quantité d'informations à envoyer.


Cookies ASP

Un cookie est souvent utilisé pour identifier un utilisateur. Un cookie est un petit fichier que le serveur intègre sur l'ordinateur de l'utilisateur. Chaque fois que le même ordinateur demande une page avec un navigateur, il enverra également le cookie.

La commande Response.Cookies est utilisée pour créer des cookies :

<%
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" permet de récupérer une valeur de cookie :

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



Inclure des fichiers

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

Syntaxe:

<!--#include virtual="unfichier.inc"-->
ou
<!--#include file ="unfichier.inc"-->

Utilisez le mot clé virtual pour indiquer un chemin commençant par un répertoire virtuel. Si un fichier nommé "header.inc" réside dans un répertoire virtuel nommé /html, la ligne suivante insérera le contenu de "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 inclus. Si vous avez un fichier dans le répertoire html et que le fichier "header.inc" réside dans html\headers, la ligne suivante insérera "header.inc" dans votre fichier :

<!-- #include file="headers\header.inc" -->

Utilisez le mot-clé file avec la syntaxe (..\) pour inclure un fichier d'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 <objet> 
  • Déclarations TypeLibrary
  • la directive #include

Événements d'application et de session

Dans Global.asa, vous pouvez indiquer aux objets application et session quoi faire lorsque l'application/session démarre et quoi faire lorsque l'application/session se termine. Le code correspondant est placé dans les gestionnaires d'événements. Remarque : Nous n'utilisons pas <% et %>, pour insérer des scripts dans le fichier Global.asa, nous devons mettre les sous-routines à l'intérieur de la balise HTML <script> :

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

<objet> Déclarations

Il est également possible de créer des objets avec une portée de session ou d'application dans Global.asa à l'aide de la balise <object>. Remarque : La balise <object> doit être en dehors de la balise <script> !

Syntaxe:

<object runat="server" scope="scope" id="id"
{progid="progID"|classid="classID"}>
.......
</object>

Déclarations TypeLibrary

Une TypeLibrary est un conteneur pour le contenu d'un fichier DLL correspondant à un objet COM. En incluant un appel à TypeLibrary dans le fichier Global.asa, les constantes de l'objet COM sont accessibles et les erreurs peuvent être mieux signalées par le code ASP. Si votre application Web s'appuie sur des objets COM qui ont déclaré des types de données dans des bibliothèques de types, vous pouvez déclarer les bibliothèques de types dans Global.asa.

Syntaxe:

 <!--METADATA TYPE="TypeLib"
file="filename"
uuid="typelibraryuuid"
version="numéro de version"
lcid="localeid"
-->


L'objet session

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

Collections

  • Contenu - Contient chaque élément ajouté à la session avec des commandes de script
  • StaticObjects - Contient chaque objet ajouté à la session avec la balise <object> et une session donnée
  • Contents.Remove( item/index ) - Supprime un élément de la collection Contents
  • Contents.RemoveAll() - Supprime chaque élément de la collection Contents

Propriétés

  • CodePage - Définit la page de code qui sera utilisée pour afficher le contenu dynamique
  • LCID - Définit l'identifiant de paramètres régionaux qui sera utilisé pour afficher le contenu dynamique
  • SessionID - Renvoie l'identifiant de la session
  • Timeout - Définit le délai d'expiration de la session

Méthode

  • Abandonner - Tue tous les objets d'un objet de session

Objet d'application

Un groupe de fichiers ASP qui fonctionnent ensemble pour réaliser un objectif est appelé une application. L'objet Application dans ASP est utilisé pour lier ces fichiers ensemble. Tous les utilisateurs partagent un objet Application. L'objet Application doit contenir des informations qui seront utilisées par de nombreuses pages de l'application (comme les informations de connexion à la base de données).

Collections

  • Contenu - Contient chaque élément ajouté à l'application avec des commandes de script
  • StaticObjects - Contient chaque objet ajouté à l'application avec la balise <object>
  • Contents.Remove - Supprime un élément d'une collection
  • Contents.RemoveAll - Supprime tous les éléments d'une collection

Méthodes

  • Verrouiller - Empêche un utilisateur de modifier les propriétés de l'objet de l'application
  • Déverrouiller - Permet à un utilisateur de modifier les propriétés de l'objet d'application

L'objet de réponse

L'objet de réponse est utilisé pour envoyer la sortie à l'utilisateur à partir du serveur.

Collection

  • Cookies(name) - Définit une valeur de cookie. Si le cookie n'existe pas, il sera créé, et prendra la valeur qui est spécifiée

Propriétés

  • Buffer - Que ce soit pour mettre en mémoire tampon la sortie ou non. Lorsque la sortie est mise en mémoire tampon, le serveur retient la réponse jusqu'à ce que tous les scripts du serveur aient été traités ou jusqu'à ce que le script appelle la méthode Flush ou End. Si cette propriété est définie, elle doit se trouver avant la balise <html> dans le fichier ASP
  • CacheControl - Définit si les serveurs proxy peuvent ou non mettre en cache la sortie. Lorsqu'il est défini sur Public, la sortie peut être mise en cache par un serveur proxy
  • Charset( charset_name) - Définit le nom du jeu de caractères (comme "ISO8859-1") sur l'en-tête du type de contenu
  • ContentType - Définit le type de contenu HTTP (comme "text/html", "image/gif", "image/jpeg", "text/plain"). La valeur par défaut est "text/html"
  • Expire - Définit la durée pendant laquelle une page sera mise en cache sur un navigateur avant son expiration
  • ExpiresAbsolute - Définit une date et une heure auxquelles une page mise en cache sur un navigateur expirera
  • IsClientConnected - Vérifie si le client est toujours connecté au serveur
  • Pics( pics_label ) - Ajoute une valeur à l'en-tête de réponse de l'étiquette des photos
  • Statut - Spécifie la valeur de la ligne de statut

Méthodes

  • AddHeader( name, value ) - Ajoute un en-tête HTML avec une valeur spécifiée
  • AppendToLog string - Ajoute une chaîne à la fin de l'entrée du journal du serveur
  • BinaryWrite( data_to_write ) - Écrit les informations données sans aucune conversion de jeu de caractères
  • Effacer - 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 provoquera une erreur d'exécution
  • Fin - 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 provoquera une erreur d'exécution
  • Redirect( url ) - Redirige l'utilisateur vers une autre URL
  • Write( data_to_write ) - Écrit un texte à l'utilisateur

Objet de requête

Lorsqu'un navigateur demande une page à un serveur, cela s'appelle une requête. L'objet de requête est utilisé pour obtenir des informations de l'utilisateur.

Collection

  • ClientCertificate - Contient les valeurs de champ stockées dans le certificat client
  • Cookies( name ) - Contient les valeurs des cookies
  • Form( element_name ) - Contient les valeurs de formulaire (entrée). Le formulaire doit utiliser la méthode post
  • QueryString( variable_name ) - Contient les valeurs des variables dans la chaîne de requête
  • ServerVariables( server_variable ) - Contient les valeurs des variables du serveur

Propriété

  • TotalBytes - Contient le nombre total d'octets que le client envoie dans le corps de la requête

Méthode

  • BinaryRead - Récupère les données envoyées au serveur par le client dans le cadre d'une demande de publication

Objet serveur

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

Propriété

  • ScriptTimeout - Définit la durée pendant laquelle un script peut s'exécuter avant de se terminer

Méthode

  • CreateObject( type_of_object ) - Crée une instance d'un objet
  • Execute( path ) - Exécute un fichier ASP à partir d'un autre fichier ASP. Après l'exécution du fichier ASP appelé, le contrôle est renvoyé au fichier ASP d'origine
  • GetLastError() - Renvoie un objet ASPError qui décrira l'erreur qui s'est produite
  • HTMLEncode( string ) - Applique l'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 ASP pour traitement. Après le transfert, le contrôle de la procédure n'est pas renvoyé au fichier ASP d'origine
  • URLEncode( string ) - Applique les règles d'encodage d'URL à une chaîne

Source : https://www.w3schools.com/asp/asp_quickref.asp