Référence rapide ASP


Référence rapide ASP de W3CSchool. Imprimez-le, mettez-le dans votre poche et préparez-le à tout moment.

Syntaxe de base

Les scripts ASP sont entourés de <% et %>. Écrivez le résultat dans le navigateur :

<html>
<body>
<% réponse.write("Bonjour tout le monde !") %>
</body>
</html>

Le langage par défaut dans ASP est VBScript. Si vous devez utiliser un autre langage de script, veuillez insérer une description du langage en haut de la page ASP :

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

<%
....
%>

Formulaires et saisies utilisateur

Request.QueryString est utilisé pour collecter des formulaires avec la valeur method="get" dans . Les informations transférées à partir d'un formulaire à l'aide de la méthode GET sont visibles par tous les utilisateurs (apparaissent dans la barre d'adresse du navigateur) et la quantité d'informations envoyées est limitée.

Request.Form est utilisé pour collecter les valeurs d'un formulaire en utilisant method="post". Les informations transférées depuis un formulaire à l'aide de la méthode POST sont invisibles pour l'utilisateur et il n'y a aucune limite sur la quantité d'informations envoyées.

Cookies ASP

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

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" est utilisée pour récupérer la valeur du cookie :

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

Fichier de référence

En utilisant la directive #include, vous pouvez y insérer le contenu d'un autre fichier ASP avant que le serveur n'exécute le fichier ASP .ASPfichier. 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"-->
ou
<!--#include file="somefile .inc"-->

Veuillez utiliser le mot clé virtual pour indiquer le chemin commençant par le 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" -->

Veuillez utiliser le fichier de mots-clés pour indiquer un chemin relatif. Les chemins relatifs commencent par le répertoire contenant le fichier référencé. Si vous avez un fichier dans le répertoire html et que le fichier "header.inc" est dans l'en-tête html, la ligne de code suivante insérera le contenu du fichier "header.inc" dans votre fichier :

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

Veuillez utiliser le mot-clé file avec la syntaxe (..) pour faire référence aux fichiers dans des répertoires de niveau supérieur.

Global.asa

Le fichier Global.asa est un fichier facultatif qui contient 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 il ne peut y avoir qu'un seul fichier Global.asa par application.

Le fichier Global.asa ne peut contenir que le contenu suivant :

  • Événement d'application

  • Événement de session

  • Déclaration<object>

  • Déclaration TypeLibrary

  • #include directive

Événements d'application et de session

Dans Global.asa, vous pouvez indiquer aux objets d'application et de session quoi faire lorsque l'application/session démarre et quoi faire lorsque l'application/session se termine. Le code permettant d'accomplir cette tâche est placé dans le gestionnaire d'événements. Remarque : Comme nous ne pouvons pas insérer de scripts utilisant les délimiteurs de script ASP (<% et %>) dans le fichier Global.asa, nous devons placer le sous-programme dans la balise HTML <script> 🎜>

<script language="vbscript" runat="server">

sous Application_OnStart
' du code
fin du sous
sous Application_OnEnd
' du code
fin du sous
sous Session_OnStart
' du code
fin du sous
sous Session_OnEnd
' du code
fin du sous
</script>

<object> La déclaration

peut être créée avec une portée de session ou d'application dans le fichier Global.asa en utilisant l'attribut <object> objet de balise.

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éclaration TypeLibrary

Une TypeLibrary est un conteneur qui contient les fichiers DLL qui correspondent aux objets COM. En incluant un appel à TypeLibrary dans le fichier Global.asa, vous pouvez accéder aux constantes de l'objet COM et votre code ASP peut mieux signaler les erreurs. Si votre application Web repose sur des objets COM de types de données 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="nom du fichier"
uuid="typelibraryuuid"
version="numéro de version"
lcid="localeid"
--->

Objet Session

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

Collection

  • Contenu - Contient toutes les entrées ajoutées à la session via des commandes de script.

  • StaticObjects - Contient tous les objets ajoutés à la session à l'aide de la balise <object>

  • Contents.Remove(item/index) - Supprime un élément de la collection Contents.

  • Contents.RemoveAll() - Supprime tous les éléments de la collection Contents.

Attributs

  • CodePage - Spécifie le jeu de caractères utilisé lors de l'affichage du contenu dynamique.

  • LCID - Définit l'identifiant de paramètres régionaux utilisé pour afficher le contenu dynamique.

  • SessionID - Renvoie l'identifiant de la session

  • Timeout - Définit ou renvoie le délai d'expiration de la session.

Méthodes

  • Abandonner - Abandonner tous les objets de l'objet de session.

Objet Application

Un ensemble de fichiers ASP qui fonctionnent ensemble pour accomplir une tâche est appelé une application. L'objet Application est utilisé pour regrouper ces fichiers. Tous les utilisateurs partagent un objet Application. L'objet Application contient des informations (telles que des informations de connexion à la base de données) qui seront utilisées par de nombreuses pages de l'application.

Collection

  • Contenu - 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 <object>

  • Contents.Remove - Supprime un élément de la collection Contents.

  • Contents.RemoveAll - Supprime tous les éléments de la collection Contents.

Méthodes

  • Verrouillage - Empêche l'utilisateur de modifier les propriétés de l'objet Application.

  • Déverrouiller - Permet à l'utilisateur de modifier les propriétés de l'objet Application.

Objet de réponse

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

Collection

  • Cookies (nom) - 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.

Attributs

  • Buffer - spécifie s'il faut mettre en mémoire tampon la sortie. Lorsque la sortie est mise en mémoire tampon, le serveur bloque les réponses au navigateur jusqu'à ce que tout le script du serveur ait été traité ou jusqu'à ce que le script appelle la méthode Flush ou End. Si vous définissez cette propriété, elle doit apparaître avant la balise <html> dans le fichier ASP.

  • CacheControl - Définit si le serveur proxy peut mettre en cache la sortie produite par ASP. S'il est défini sur Public, le serveur proxy met la page en cache.

  • Charset(charset_name) - Ajoute le nom du jeu de caractères (tel que "ISO8859-1") à l'en-tête de type de contenu dans l'objet Response.

  • ContentType - Définit le type de contenu HTTP de l'objet Response (par exemple "text/html", "image/gif", "image/jpeg", "text/plain"). La valeur par défaut est "text/html".

  • Expire - Définissez la durée du cache du navigateur (minutes) avant l'expiration de la page.

  • ExpiresAbsolute - Définissez la date et l'heure auxquelles le cache des pages expirera sur le navigateur.

  • IsClientConnected - Indique si le client s'est déconnecté du serveur.

  • Pics(pics_label) - Ajoute une valeur à l'étiquette PICS de 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 au En-têtes et valeurs HTTP de réponse HTTP.

  • AppendToLog string - Ajoute une chaîne à la fin de l'entrée du journal du serveur.

  • BinaryWrite(data_to_write) - écrit les données directement dans la sortie sans aucune conversion de caractères.

  • Effacer - Effacer 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érera 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 générera une erreur d’exécution.

  • Redirect(url) - Redirige l'utilisateur vers une autre URL.

  • Write(data_to_write) - Écrit du texte à l'utilisateur.

Objet de requête

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

Collection

  • ClientCertificate - Contient toutes les valeurs de champ stockées dans le certificat client.

  • Cookies(nom) - Contient toutes les valeurs de cookies envoyées dans la requête HTTP.

  • Form(element_name) - Contient toutes les valeurs de formulaire (entrée) envoyées par le formulaire à l'aide de 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 du 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érer les données envoyées du client au serveur dans le cadre d'une demande de publication.

Objet Serveur

L'objet Serveur 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 de se terminer.

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 l’exécution du fichier ASP appelé terminée, le contrôle revient au fichier ASP d’origine.

  • GetLastError() - Renvoie un objet ASPError qui décrit l'état de 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.

  • Transfert(chemin) - Envoie toutes les informations d'état vers un autre fichier pour traitement. Après le transfert, le contrôle du programme n'est pas renvoyé au fichier ASP d'origine.

  • URLEncode(string) - Applique les règles de codage d'URL à une chaîne.

Source : http://www.w3cschool.cc/asp/asp-quickref.html