Collection Request.Form

Synopsis

Lecture seule

Cette collection contient les valeurs des différents éléments d'un formulaire envoyé par la méthode POST.

Attention ! Cette collection ne permet pas de gérer l'envoi de fichiers attachés au serveur. Il faut utiliser une librairie spéciale.

Element est le seul paramètre obligatoire.

Utilisation de la collection

Les éléments

C'est la façon la plus directe d'accéder aux différents éléments d'un formulaire. Element est le nom utilisé dans le formulaire pour désigner l'élément.

<FORM action="formulaire.asp" method="post">
	login : <INPUT type="text" name="login" size="20"><BR>
	mot de passe : <INPUT type="password" name="mot_de_passe" size="20">
	<INPUT type="submit" value="OK">
</FORM>

En VBScript, comme toutes les collections, il est possible de parcourir Request.Form avec une boucle for each ... next :

For Each element In Request.Form
	Response.Write(element & " = " & Request.Form(element))
Next

Les éléments à valeurs multiples

Certains éléments peuvent contenir plusieurs sous-valeurs. Cela arrive par exemple lorsqu'on utilise des listes à choix multiple ou des zones de cases à cocher dans les formulaires (en fait, dè l'instant où plusieurs éléments du formulaire portent le même nom). On accède alors à ces sous-valeurs avec un entier (Index). Cet entier commence à 1. L'attribut Count donne le nombre de sous-valeurs contenues dans l'élément :

<FORM action="formulaire.asp" method="post">
	<SELECT name="liste" size="10" multiple>
		<OPTION value="element_1">element 1</OPTION>
		<OPTION value="element_2">element 2</OPTION>
		...
	</SELECT>
	<INPUT type="submit" value="OK">
</FORM>

<FORM action="formulaire.asp" method="post">
	<INPUT type="checkbox" name="liste" value="element_1"> element 1<BR>
	<INPUT type="checkbox" name="liste" value="element_2"> element 2<BR>
	...
	<INPUT type="submit" value="OK">
</FORM>

<%
Response.Write(Request.Form("liste").Count & " elements :<BR>")
For i = 1 To Request.Form("liste").Count
	Response.Write(Request.Form("liste")(i) & "<BR>")
Next
%>

Ce qui donne, si on a sélectionné ou coché les éléments 1, 5 et 13 :

3 elements :
element_1
element_5
element_13

Par ailleurs, Response.Write(Request.Form) va afficher une chaîne de caractères identique à la chaîne de requête correspondant à l'envoi du formulaire par la méthode GET (voir Request.QueryString).