• Samedi 26 juillet 2008 - 00:11:11
• inscrits : 889779
• connectés : 21507
• questions/jour : 4153
• Taux de réponse : 84.58%

Présentation de l'objet Request

Le rôle de l'objet Request est de permettre de récupérer la requête HTTP envoyée par le client au serveur, c'est-à-dire qu'il permet en réalité de manipuler l'ensemble des informations envoyées par le navigateur du visiteur (page demandée, nom et version du navigateur, cookies stockés sur le disque du client, adresse IP du client, ...).

Les constituants de l'objet Request

L'objet Request possède plusieurs collections, une propriété et une méthode :

La majorité des propriétés et des méthodes de l'objet Request correspondent à des fonctions ou propriétés permettant de manipuler les champs de la requête HTTP.

La réception de données

Pour comprendre comment utiliser l'objet Request, il est nécessaire de connaître la manière de laquelle les données sont envoyées au navigateur grâce à la requête HTTP. Pour cela réferrez-vous à la section « formulaire HTML ».

L'envoi de données à un script CGI se fait par l'intermédiaire d'un formulaire HTML.

Les formulaires HTML se créent à l'aide de la balise <FORM> contenant des boutons, des champs, des listes et/ou des cases à cocher repérés par des noms auxquels seront associés des valeurs, fonction de la saisie des utilisateurs, puis d'un bouton de soumission du formulaire qui enverra l'ensemble des informations au script indiqué en tant qu'attribut Action de la balise FORM selon la méthode GET ou POST. Chaque élément du formulaire doit posséder un nom unique, de telle façon que la valeur associée à l'élément forme avec le nom de celui-ci une paire nom/valeur du type :

Nom_de_l_element=valeur

L'ensemble des paires nom/valeur sont séparées par des esperluettes (le caractère « & »). Ainsi, l'envoi d'un formulaire crée une chaîne de la forme :

champ1=valeur1&champ2=valeur2&champ3=valeur3

L'envoi de cette chaîne se fera différemment selon que la méthode utilisée pour l'envoi du formulaire est GET ou POST.

• la méthode GET permet d'envoyer les éléments du formulaire au travers de l'URL du script, en ajoutant l'ensemble des paires nom/valeur à l'URL du script, séparé de celui-ci par un point d'interrogation, ce qui donne une URL du type :

  http://nom_du_serveur/cgi-bin/script.cgi?champ1=valeur1&champ2=valeur2...

  
  Toutefois, la longueur de la chaîne URL étant limitée à 255 caractères, les informations situées au-delà de cette limite seront irrémédiablement perdues. De plus, cela crée une URL surchargée dans la barre d'adresse d'un navigateur et peut dévoiler des informations sensibles comme un mot de passe...
• la méthode POST est une bonne alternative à la méthode GET. Cette méthode code les informations de la même façon que la méthode GET (encodage URL et paires nom/valeur) mais elle envoie les données à la suite des en-têtes HTTP, dans un champ appelé corps de la requête. De cette façon la quantité de données envoyées n'est plus limitée, et est connue du serveur grâce à l'en-tête permettant de connaître la taille du corps de la requête.

Il est possible de lire les informations transmises à la page cible avec une seule et unique méthode et ce quelle que soit la méthode d'envoi (GET ou POST).
Par exemple :

dim sParam1 : sParam1 = Request("Param1")
dim sParam2 : sParam2 = Request("Param2")

La collection QueryString

La collection QueryString permet de récupérer la chaîne de requête envoyée par le client, c'est-à-dire les paires clés/valeurs présentes dans l'URL après le point d'interrogation. Prenons par exemple l'URL suivante :

http://www.commentcamarche.net/asp/caddie.asp?param=12&nom=Jeff

La chaîne de requête est ainsi la suivante :

param=12&nom=Jeff

param et nom sont ici des champs (parfois appelés clés) et leurs valeurs respectives sont 12 et Jeff.

Voici la syntaxe de la collection QueryString :

<%@ LANGUAGE="VBSCRIPT" %>

<% Request.QueryString("Champ")[(Index)|.Count] %>

• Le paramètre champ désigne la variable que l'on désire récupérer. Il s'agit d'un paramètre obligatoire.
• Le paramètre optionnel index permet de définir de façon plus précise le champ auquel on fait référence, lorsqu'il existe plusieurs champs de même nom.
• Le paramètre optionnel .count permet de connaître le nombre de variables possédant le nom champ.

Ainsi, la récupération de la variable nom dans l'exemple ci-dessus se fera grâce à l'instruction suivante :

<% Request.QueryString("nom") %>

Dans le cas où le formulaire possède plusieurs éléments de même nom (c'est le cas des cases à cocher et des menus à multiples sélections), il est possible de parcourir les éléments grâce aux paramètres index et count de la collection QueryString. Soit le formulaire suivant :

<FORM action="mes_loisirs.asp" method="get">

	<BR><INPUT type="checkbox" name="choix" value="musique"> musique
	<BR><INPUT type="checkbox" name="choix" value="cinéma"> cinéma
	<BR><INPUT type="checkbox" name="choix" value="sport"> sport
	<BR><INPUT type="checkbox" name="choix" value="théâtre"> théâtre
	<BR><INPUT type="submit" value="Valider la sélection">

</FORM>

Il est possible d'afficher le nombre de choix sélectionnés, ainsi que de les lister de la façon suivante dans le fichier mes_loisirs.asp (valeur de l'attribut action du formulaire ci-dessus ; le fichier mes_loisirs.asp pouvant être le même fichier que celui contenant le formulaire).

<%
Response.Write "J'ai sélectionné "
& Request.QueryString("choix").Count
& " loisirs : <BR>"
for i = 1 to Request.QueryString("choix").Count
	Response.Write "<BR>"
	& Request.QueryString("choix")(i)
next
%>

Il est possible d'afficher tous les champs d'un formulaire en utilisant la clause For Each du VBScript, qui permet de parcourir l'ensemble des enregistrements d'une collection. Voici un script qui affiche l'ensemble des valeurs associées aux champs d'un formulaire après envoi au serveur :

<%@ LANGUAGE="VBSCRIPT" %>

<%
For Each Champ in Request.QueryString
Response.write(Champ & " = " & Request.QueryString(Champ))
Next
%>

<BR>

Enfin pour afficher tous les champs, et les valeurs prises par chaque champ, voici un exemple de code :

<%@ LANGUAGE="VBSCRIPT" %>

<%
For Each Champ in Request.QueryString
Response.write("<P>" & Champ & " : " & Request.QueryString(Champ))
	For i = 1 to Request.QueryString(Champ).Count
	Response.Write("<BR>Valeur numéro "
	& Request.QueryString("choix").Count
	& ": " & Request.QueryString(Champ)(i))
	Next
Next
%>

<BR>

La collection Form

Alors que la collection QueryString permet de récupérer de façon simple les données envoyées au script ASP par l'intermédiaire de l'URL (ou plus exactement par la méthode GET du protocole HTTP), la collection Form permet de manipuler les données envoyées par un formulaire en utilisant la méthode POST.

La collection Form permet de récupérer la valeur associée à un champ par la syntaxe suivante :

<%@ LANGUAGE="VBSCRIPT" %>

<% Request.Form("Champ") %>

Ainsi pour afficher tous les champs d'un formulaire, il est possible, comme pour la collection QueryString, d'utiliser la clause For Each du VBScript, permettant de parcourir les enregistrements d'une collection. Voici un script qui affiche l'ensemble des valeurs associées aux champs d'un formulaire après envoi au serveur :

<%@ LANGUAGE="VBSCRIPT" %>

<% For Each Champ in Request.Form %>

<%
Response.write(Champ + " = ")
Response.write(Request.Form(Champ)) %>

<%BR%>

<% Next %>

La collection Cookies

La collection Cookies permet de récupérer les valeurs d'un cookie, c'est-à-dire un fichier présent sur le disque du client contenant des données envoyées par le serveur (un cookie peut être créé grâce à l'objet Response).

L'accès aux données d'un cookie se fait de la manière suivante :

<%@ LANGUAGE="VBSCRIPT" %>

<% Variable = Request.Cookies("NomCookie")("Element") %>

Il est possible de parcourir l'ensemble des cookies par le script suivant :

<%@ LANGUAGE="VBSCRIPT" %>

<% For Each Element in Request.Cookies %>

<%
Response.write(Element + " = ")
Response.write(Request.Cookies(Element)) %>

<BR>

<% Next %>

La collection ServerVariables

La collection ServerVariables de l'objet Request contient les en-têtes HTTP de la requête, pouvant parfois donner des informations très utiles sur les visiteurs ou le nom et la version du navigateur du client...

La syntaxe pour récupérer ces en-têtes est la suivante :

Request.ServerVariables("NOM-EN-TETE")

Voici les principaux en-têtes pouvant être utiles :

Pour compter les visiteurs d'un site en ne retenant que les nouveaux, il peut être intéressant de stocker l'adresse IP de ces derniers si celle-ci ne figure pas dans la liste déjà enregistrée. Voici le code permettant de stocker dans une variable l'adresse IP d'un visiteur, et qui l'affiche :

<%@ LANGUAGE="VBSCRIPT" %>

<%
IP = Request.ServerVariables("REMOTE_ADDR")
Response.write("Votre adresse IP est : " + IP) %>

<BR>

La collection ClientCertificate

La collection ClientCertificate contient l'ensemble des enregistrements contenus dans le certificat d'authentification envoyé par le client au serveur dans la requête HTTP lors d'une connexion via SSL, c'est-à-dire lors d'une requête dont l'URL commence par https:// au lieu de http://. Afin de pouvoir utiliser correctement cette collection, le navigateur du client doit être capable d'envoyer des certificats et le serveur doit supporter SSL. Dans le cas contraire, la collection ClientCertificate renvoie la valeur EMPTY.

La syntaxe de cette collection est la suivante :

Request.ClientCertificate(Cle[Suffixe])

• L'attribut clé obligatoire correspond au champ du certificat que l'on désire récupérer. La liste des clés possibles est explicitée ci-dessous.
• L'attribut optionnel Suffixe, lorsqu'il est accolé à la clé Subject ou Issuer (les deux seules clés pour lesquelles il est possible d'utiliser un suffixe) permet de préciser la partie du champ que l'on désire récupérer.

Voici l'ensemble des champs du certificat qu'il est possible de récupérer grâce à la collection ClientCertificate :

Voici l'ensemble des suffixes pouvant éventuellement être utilisés avec les champs Issuer et Subject du certificat (par exemple IssuerC donnera le pays de l'émetteur du certificat) :

Il est ainsi possible d'afficher le nom de l'utilisateur qui a émis le certificat de la façon suivante :

<%= Request.ClientCertificate("IssuerCN") %>

Le script suivant affiche l'intégralité des champs contenus dans le certificat :

<%
  Const ceCertPresent = 1
  Const ceUnrecognizedIssuer = 2
  If Request.ClientCertificate("Flags") = ceCertPresent Then
  	For Each cle in Request.ClientCertificate
		Response.Write cle & " = " & Request.ClientCertificate(cle) & "<br>"
  	Next
  Else
  	Response.Write "Le client n'a pas de certificat ou est inconnu"
  End If
%>

La méthode BinaryRead()

La collection Post permet de manipuler la plupart des informations contenues dans la requête du client. Toutefois certaines informations, comme par exemple les données binaires envoyées par le client lors de l'envoi d'un fichier (en anglais upload), ne peuvent être traitées par la seule collection Form.

Ainsi, la méthode BinaryRead() de l'objet Request permet de récupérer les données brutes envoyées dans une requête POST. A l'inverse, la méthode BinaryWrite() de l'objet Response permet de créer le corps de la réponse HTTP.
La syntaxe de la méthode BinaryRead() est la suivante :

Request.BinaryRead(n)

• Le paramètre obligatoire n indique le nombre d'octets à lire dans le corps de la requête POST. Il est possible de connaître la taille totale en octets du corps de la requête POST grâce à la propriété TotalBytes de l'objet Request. Il est donc essentiel de s'assurer que le nombre d'octets n à lire est inférieur ou égal à la valeur de TotalBytes.
• La méthode BinaryRead retourne les n premiers octets de la requête POST.

L'exemple suivant illustre la façon basique de récupérer le corps de la requête POST :

<%
  Dim DonneesPost, Compteur
  Compteur = Request.TotalBytes
  DonneesPost = Request.BinaryRead(Compteur)
  if DonneesPost != 0
  Response.BinaryWrite(DonneesPost)
  end if
%>

Plus d'information

• ASPfr.com

• Dans les astuces
• Dans le forum
• Dans les logiciels
• Dans le guide d'achat

Trucs & astuces pertinents trouvés dans la base de connaissances

12/01 12h26	[Gravure] Pilotes ASPI pour lecteur/graveur de CD/DVD	Gravure
13/01 12h40	[Aspirateur de pages HTML] Comment aspirer un site Web ?	Web
27/01 16h03	=CHANGER L ASPECT DU CURSEUR EN CSS=	CSS
25/09 11h21	[Webmaster] Empêcher l'aspiration de mon site	Webmaster
14/04 18h33	Commandes du fichier CONFIG.SYS	MS-Dos

Plus d'astuces sur « ASP »

• Dans les astuces
• Dans le forum
• Dans les logiciels
• Dans le guide d'achat

Discussions pertinentes trouvées dans le forum

23/07 15h00	Renseignements sur Acer Aspire 1804 WSMi	8
20/07 10h25	Problème avec acer aspire 7520 G	4
19/07 11h52	Aspiratuer de site web	4
13/07 20h12	Acer aspire one clavier en anglais	10
10/07 20h48	Crysis avec ACER Aspire 8920	9

Plus de discussions sur « ASP »

• Dans les astuces
• Dans le forum
• Dans les logiciels
• Dans le guide d'achat

Logiciels pertinents trouvés dans les téléchargements

	ASPI Drivers - Le fichier wnaspi32.dll représente un pilote ASPI permettant à des logiciels de gravure de reconnaitre et de manipuler des...	Catégorie: Gravure Licence: Freeware/gratuit
	Vista Inspirat - Le BricoPack Vista Inspirat est un pack gratuit qui permet de modifier les fichiers systèmes de Windows XP afin de lui...	Catégorie: Personnalisation Licence: Freeware/gratuit
	HTTrack - HTTrack est un aspirateur de site très puissant et open source. Ses nombreuses options de configuration en font un outil de...	Catégorie: Aspirateurs de site Licence: Open Source
	MediaInfo - MediaInfo fournit la liste des codecs nécessaires ainsi que des informations techniques sur vos fichiers vidéo et audio. ...	Catégorie: Codecs Licence: Open Source

Plus de logiciels gratuits sur « ASP »

• Dans les astuces
• Dans le forum
• Dans les logiciels
• Dans le guide d'achat

Produits relatifs

	Acer AspireT135 AMD Sempron	Catégorie: Ordinateur de bureau
	Acer Aspire1363WLMi	Catégorie: Ordinateur portable
	Event ASP6	Catégorie: Enceintes
	Acer AspireT671 Intel Core	Catégorie: Ordinateur de bureau

Plus de produits sur « ASP »