HtmlHelper.DropDownList 方法 (String, String, IEnumerable<SelectListItem>, Object)

傳回 HTML 下拉式清單控制項,此控制項含有指定名稱和透過屬性物件定義的自訂屬性,並包含指定清單項目和預設項目。

命名空間:  System.Web.WebPages.Html
組件:  System.Web.WebPages (在 System.Web.WebPages.dll 中)

public IHtmlString DropDownList(
	string name,
	string defaultOption,
	IEnumerable<SelectListItem> selectList,
	Object htmlAttributes
)

參數

name
型別:System.String

指派給 HTML select 項目之 name 屬性的值。

defaultOption
型別:System.String

要針對清單中預設選項顯示的文字。

selectList
型別:System.Collections.Generic.IEnumerable<SelectListItem>

用來填入清單的 SelectListItem 執行個體清單。

htmlAttributes
型別:System.Object

包含元素之自訂屬性的物件。這些屬性 (Attribute) 名稱和值是藉由檢查物件之屬性 (Property),透過反映所擷取而來。

傳回值

型別:System.Web.IHtmlString
表示下拉式清單控制項的 HTML 標記。

例外狀況條件
ArgumentException

namenull 或空白。

傳回的標記是由下列形式的 HTML select 項目所組成:

<select name="name" ...htmlAttributes...>
  <option>defaultOption</option>
  <option value="selectList[0].Value">selectList[0].Text</option>
  <option value="selectList[1].Value">selectList[1].Text</option>
  ...
</select>

預設選項會出現在清單的開頭且其值為空白。預設選項可用來傳達並未從清單中選擇任何選項,例如,當下拉式控制項表示選用參數時。

顯示: