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

傳回 HTML 清單方塊控制項,此控制項含有指定的名稱和透過屬性字典定義的自訂屬性,並包含指定的清單項目和預設項目。

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

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

參數

name
型別:System.String

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

defaultOption
型別:System.String

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

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

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

htmlAttributes
型別:System.Collections.Generic.IDictionary<String, Object>

元素之自訂屬性的名稱和值。

傳回值

型別:System.Web.IHtmlString
代表清單方塊控制項的 HTML 標記。

例外狀況條件
ArgumentException

namenull 或空白。

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

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