Référence rapide ASP

Référence rapide ASP de CodeW3C.com. Imprimez-la, mettez-la dans votre poche, pour une utilisation à tout moment.

Grammaire de base

Les scripts ASP sont entourés par <% et %>. De cette manière, le contenu est envoyé au navigateur :

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

Le langage par défaut dans ASP est VBScript. Si vous souhaitez utiliser un autre langage de script, insérez une déclaration de langage en haut de la page ASP :

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

Formulaire et entrée utilisateur

Request.QueryString est utilisé pour collecter les valeurs des champs d'un formulaire whose method est "get". Les informations envoyées par le GET via un formulaire sont visibles pour tout le monde (elles s'affichent dans l'adresse de la barre de navigation du navigateur) et ont une limite quant à la quantité de données envoyées.

Request.Form est utilisé pour collecter les valeurs des champs d'un formulaire whose method est "post". Les informations envoyées par le POST via un formulaire ne sont pas visibles pour les autres personnes et n'ont pas de limite quant à la quantité de données envoyées.

Cookies ASP

Les cookies sont utilisés couramment pour identifier les utilisateurs. Un cookie est un petit fichier que le serveur insère dans le ordinateur de l'utilisateur. Chaque fois que le même ordinateur demande une page via un navigateur, le cookie est également envoyé.

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

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

Remarque : La commande Response.Cookies doit se trouver avant les balises <html> !

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

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

Référence de fichier

Grâce à l'instruction #include, vous pouvez insérer le contenu d'un fichier ASP dans un autre ASP avant son exécution sur le serveur. L'instruction #include est utilisée pour créer des fonctions, des en-têtes de page, des pieds de page ou des éléments réutilisés sur plusieurs pages.

Syntaxe :

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

ou

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

Veuillez utiliser le mot-clé virtual pour indiquer le chemin qui commence par un répertoire virtuel. Si le fichier nommé "header.inc" se trouve dans le répertoire virtuel nommé /html, alors le code suivant insérera le contenu de "header.inc":

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

Please use the keyword file to indicate the relative path. The relative path starts with the directory that contains the referenced file . If your file is located in the html directory, and the file "header.inc" is located in html\headers, the following code will insert the content of "header.inc" into your file :

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

Please use the keyword file with the syntax (..\) to refer to files in higher-level directories .

Global.asa

The Global.asa file is an optional file that can contain objects, variables, and methods that can be accessed by each page in the ASP application .

Comment : The Global.asa file must be stored in the root directory of the ASP application, and each application can only have one Global.asa file .

The Global.asa file can only contain the following :

  • Application events
  • Session events
  • <object> declaration
  • Déclaration de TypeLibrary
  • #include directive

Application and Session events

In Global.asa, you can tell what the application and session objects should do when the application/session starts and when it ends. The code to complete this task is located in the event handler.

Comment : When inserting code into the Global.asa file, we do not use <% and %>, we need to place the subroutine inside the HTML <script> tag :

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

<object> declaration

By using the <object> tag, you can also create objects with session or application scope in Global.asa .

Comment : The <object> tag should be placed outside the <script> tag !

Syntaxe :

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

Déclaration de TypeLibrary

La TypeLibrary est un conteneur de contenu pour les fichiers DLL correspondant aux objets COM. En incluant l'appel à la TypeLibrary dans le fichier Global.asa, il est possible d'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 déclarés dans une bibliothèque de types, vous pouvez déclarer cette 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 la session de l'utilisateur ou pour modifier ses paramètres. Les variables stockées dans l'objet Session contiennent des informations sur un utilisateur individuel et peuvent être accédées par toutes les pages d'une application.

Collection

  • Contenus - Contient tous les éléments ajoutés à la session par des commandes de script
  • StaticObjects - Contient tous les objets ajoutés à la session en utilisant le tag <object> HTML
  • Contents.Remove(item/index) - Supprime un élément du jeu de contenus
  • Contents.RemoveAll() - Supprime tous les éléments du jeu de contenus

Propriété

  • CodePage - Définit le jeu de caractères utilisé pour afficher le contenu dynamique
  • LCID - Définit l'identifiant de région utilisé pour afficher le contenu dynamique
  • SessionID - Retourne l'ID de session
  • Timeout - Définit ou retourne le temps d'expiration de la session

Méthode

  • Abandon - Annule tous les objets dans l'objet session.

Objet Application

Un ensemble de fichiers ASP qui travaillent ensemble pour accomplir une tâche est appelé une application. L'objet Application dans ASP est utilisé pour regrouper ces fichiers. Tous les utilisateurs partagent un objet Application. L'objet Application doit contenir des informations utilisées par de nombreuses pages de l'application (par exemple, des informations de connexion à la base de données).

Collection

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

Méthode

  • Lock - Empêche l'utilisateur de modifier les variables de l'objet Application
  • Unlock - Permet à l'utilisateur de modifier les variables de l'objet Application

L'objet Response

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

Collection

Cookies(name) - Définit la valeur du cookie. S'il n'existe pas, un cookie est créé et la valeur spécifiée est définie.

Propriété

  • Buffer - Définit si la sortie doit être mise en cache. Lorsque la sortie est mise en cache, le serveur bloque la réponse au navigateur jusqu'à ce que tous les scripts serveurs soient traités, ou jusqu'à ce que le script appelle Flush ou End. Si vous devez définir cette propriété, elle doit se trouver avant la balise <html> dans le fichier .asp.
  • CacheControl - Définit si le serveur proxy peut stocker en cache la sortie générée par ASP. Si il est réglé sur Public, le serveur proxy stockera la page.
  • Charset(charset_name) - Ajoute le nom du jeu de caractères au en-tête content-type de l'objet de réponse
  • ContentType - Définit le type de contenu HTTP de l'objet de réponse. (par exemple "text/html", "image/gif", "image/jpeg", "text/plain"). Par défaut, il est "text/html"
  • Expires - Définit le temps du cache du navigateur avant que la page ne expire (minutes)
  • ExpiresAbsolute - Définit la date et l'heure à laquelle le cache de la page du navigateur expire
  • IsClientConnected - Indique si le client s'est déconnecté du serveur
  • Pics(pics_label) - Ajoute une valeur à la marque PICS de l'en-tête de réponse
  • Status - Définit la valeur de la ligne d'état renvoyée par le serveur

Méthode

  • AddHeader(name, value) - Ajoute un nouveau en-tête HTTP et une valeur de réponse HTTP
  • AppendToLog string - Ajoute une chaîne au bas du journal du serveur (entrée de journal du serveur)
  • BinaryWrite(data_to_write) - Écrit directement des données à l'output sans conversion de caractères
  • Clear - Efface la sortie mise en cache. Utilisez cette méthode pour traiter les erreurs. Si Response.Buffer n'est pas réglé sur true, cette méthode génère une erreur de temps d'exécution
  • End - Arrête le traitement du script et retourne le résultat actuel
  • Flush - Envoie immédiatement la sortie mise en cache. Si Response.Buffer n'est pas réglé sur true, cette méthode génère une erreur de temps 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, cela est appelé une requête. L'objet Request est utilisé pour obtenir des informations de l'utilisateur.

Collection

  • ClientCertificate - Contient les valeurs des champs stockés dans le certificat client
  • Cookies(name) - Contient les valeurs des cookies
  • Form(element_name) - Contient les valeurs des formulaires. Ce formulaire doit utiliser la méthode POST
  • QueryString(variable_name) - Contient la valeur des variables dans la chaîne de requête
  • ServerVariables(server_variable) - Contient la valeur de la variable de serveur

Propriété

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

Méthode

  • BinaryRead - Retourne les données envoyées du client au serveur en tant que partie 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é

ScriptTimeout - Définit ou retourne le temps que peut s'exécuter un script avant de se terminer.

Méthode

  • CreateObject(type_of_object) - Crée une instance d'un objet
  • Execute(chemin) - Exécute un autre fichier ASP à l'intérieur d'un fichier ASP. Le contrôle de la main est retourné au fichier ASP d'origine après l'exécution du fichier ASP appelé
  • ) - Retourne l'objet ASPError décrivant l'erreur qui s'est produite
  • HTMLEncode(string) - Applique l'encodage HTML à une chaîne
  • MapPath(chemin) - Mappe un chemin relatif ou virtuel à un chemin physique
  • Transfer(chemin) - Envoyer toutes les informations d'état à un autre fichier pour préparation. Après l'envoi, le contrôle du programme ne revient pas au fichier ASP d'origine
  • URLEncode(string) - Appliquer les règles d'encodage URL aux chaînes

Source : http://www.codew3c.com/asp/asp_quickref.asp