Form

Form 컬렉션은 POST 메서드를 사용하는 양식으로 HTTP 요청 본문에 전송된 양식 요소 값을 검색합니다.

구문

Request.Form(element)[(index)|.Count]

매개 변수

element: 컬렉션이 값을 검색할 양식 요소 이름입니다.
index: 한 매개 변수에 대한 여러 값 중 하나에 액세스할 수 있도록 하는 선택적인 매개 변수입니다. 1부터 Request.Form(parameter).Count까지의 정수가 될 수 있습니다.

주의

Form 컬렉션은 매개 변수 이름으로 요청 본문에 인덱스됩니다. Request.Form(element) 값은 요청 본문에서 발생하는 모든 element 값의 배열입니다. Request.Form(element).Count를 호출하여 한 매개 변수 값의 수를 파악할 수 있습니다. 매개 변수에 여러 값이 연결되어 있지 않다면 매개 변수 값의 수는 1이며 매개 변수 자체가 없다면 0입니다.

여러 값을 가지는 양식 요소에서 한 개의 값만 참조하려면 index에 대한 값을 지정해야 합니다. index 매개 변수는 1부터 Request.Form(element).Count 사이의 수가 될 수 있습니다. index에 값을 지정하지 않고 여러 양식 매개 변수 중 하나를 참조하면, 데이터는 쉼표로 구분된 문자열로 반환됩니다.

Request.Form에 매개 변수를 사용하면 웹 서버는 HTTP 요청 본문을 분석하여 지정된 데이터를 반환합니다. 응용 프로그램이 양식에서 분석되지 않은 데이터를 요구하는 경우에는 매개 변수 없이 Request.Form을 호출하여 이런 데이터에 액세스할 수 있습니다.

참고 ASP를 사용하여 100KB 이상의 대용량 데이터를 게시하는 경우, Request.Form을 사용할 수 없습니다. 사용자 응용 프로그램에서 100KB가 넘는 데이터를 게시해야 하는 경우 Request.BinaryRead 메서드를 사용하는 구성 요소가 기록됩니다.

양식 요청에 있는 모든 데이터 값을 반복할 수 있습니다. 예를 들어, 사용자가 FavoriteFlavor 요소에 대한 값으로 Chocolate과 Butterscotch를 지정하여 양식을 작성했으면 다음 스크립트를 사용하여 이들 값을 검색할 수 있습니다.

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

위의 스크립트는 다음을 표시합니다.

Chocolate
Butterscotch

이 방법을 사용하여 다음 스크립트에서처럼 매개 변수 이름을 표시할 수 있습니다.

<% 
  For i = 1 to Request.Form("FavoriteFlavor").count %>
    Request.Form(FavoriteFlavor) = <%= Request.Form("FavoriteFlavor")(i)_
    %> <BR>
<% Next %>

이 스크립트는 브라우저에 다음 내용을 표시합니다.

Request.Form(FavoriteFlavor) = Chocolate
Request.Form(FavoriteFlavor) = Butterscotch

예제

다음과 같은 양식을 생각해 볼 수 있습니다.

<FORM ACTION = "/scripts/submit.asp" METHOD = "post">
<P>Your first name: <INPUT NAME = "firstname" SIZE = 48>
<P>What is your favorite ice cream flavor: <SELECT NAME = "flavor">
<OPTION>Vanilla 
<OPTION>Strawberry 
<OPTION>Chocolate 
<OPTION>Rocky Road</SELECT>
<P><INPUT TYPE = SUBMIT>
</FORM>

위의 양식에서는 다음 요청 본문이 보내집니다.

firstname=James&flavor=Rocky+Road

다음 스크립트를 사용하면

Welcome,  <%= Request.Form("firstname") %>. 
Your favorite flavor is <%= Request.Form("flavor") %>.

다음과 같은 결과가 나옵니다.

Welcome, James. Your favorite flavor is Rocky Road.

다음 스크립트를 사용하면

The unparsed form data is:  <%= Request.Form %>

다음과 같은 결과가 나옵니다.

The unparsed form data is:  firstname=James&flavor=Rocky+Road

참고 양식에 이름이 같은 개체를 여러 개 포함하면(예: HTML SELECT 태그) 양식 컬렉션의 항목은 선택된 모든 값을 쉼표로 구분하여 열거한 형식이 됩니다.

적용

Request 개체