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 參數時，Web 服務器將分析 HTTP 請求正文并返回指定的數據。如果應用程序需要未分析的表格數據，可以通過調用不帶參數的 Request.Form 訪問該數據。

使用重述符可以遍歷表格請求中的所有數據值。例如，用戶通過指定兩個值填寫表格，Chocolate 和 Butterscotch。對于 FavoriteFlavor 參數，您可以使用下面的腳本檢索這些值。

<%For Each item In Request.Form("FavoriteFlavor")  Response.Write item & "<BR>"Next%> 

上述腳本顯示如下。

ChocolateButterscotch 

使用 For...Next 循環可以生成同樣的輸出，如下列腳本所示。

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

使用該復述符可以顯示參數名。如下列腳本所示。

<% For Each x In Request.Form %>Request.Form( <%= x %> ) = <%= Request.Form(x) %> <BR><% Next %> 

該腳本在瀏覽器上顯示下列信息。

FavoriteFlavor = ChocolateFavoriteFlavor = 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 

應用于

Request Object