HtmlHelperSelectExtensions.DropDownList 方法

定義

命名空間:

Microsoft.AspNetCore.Mvc.Rendering

組件:

Microsoft.AspNetCore.Mvc.ViewFeatures.dll

套件:

Microsoft.AspNetCore.App.Ref v8.0.0

多載

DropDownList(IHtmlHelper, String)	傳回 的單一選取 HTML < 選取 > 專案 expression 。 <根據具有完整名稱的專案加入 ViewData 選項 > 專案。 如果 Value (非 Textnull) 或符合中找到的第一個非 null 值，則將其 「選取」屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案，或 expression 針對 進行評估的 Model 。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。
DropDownList(IHtmlHelper, String, IEnumerable<SelectListItem>)	傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 selectList 新增 < 選項 > 專案。 如果 Value (非 null) 或 Text 符合中找到的第一個非 null 值，則會將 「selected」 屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案、 ViewData 具有完整名稱的專案 (，除非使用 selectList 而非) ，否則 expression 會針對 Model 進行評估。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。
DropDownList(IHtmlHelper, String, String)	傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 optionLabel 和 ViewData 具有完整名稱的專案，加入 < 選項 > 專案。 如果 Value (非 Textnull) 或符合中找到的第一個非 null 值，則將其 「選取」屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案，或 expression 針對 進行評估的 Model 。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。
DropDownList(IHtmlHelper, String, IEnumerable<SelectListItem>, Object)	傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 selectList 新增 < 選項 > 專案。 如果 Value (非 null) 或 Text 符合中找到的第一個非 null 值，則會將 「selected」 屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案、 ViewData 具有完整名稱的專案 (，除非使用 selectList 而非) ，否則 expression 會針對 Model 進行評估。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。
DropDownList(IHtmlHelper, String, IEnumerable<SelectListItem>, String)	傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 optionLabel 和 selectList 加入 < 選項 > 專案。 如果 Value (非 null) 或 Text 符合中找到的第一個非 null 值，則會將 「selected」 屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案、 ViewData 具有完整名稱的專案 (，除非使用 selectList 而非) ，否則 expression 會針對 Model 進行評估。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。

DropDownList(IHtmlHelper, String)

來源:

HtmlHelperSelectExtensions.cs

傳回 的單一選取 HTML < 選取 > 專案 expression 。 <根據具有完整名稱的專案加入 ViewData 選項 > 專案。 如果 Value (非 Textnull) 或符合中找到的第一個非 null 值，則將其 「選取」屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案，或 expression 針對 進行評估的 Model 。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::AspNetCore::Html::IHtmlContent ^ DropDownList(Microsoft::AspNetCore::Mvc::Rendering::IHtmlHelper ^ htmlHelper, System::String ^ expression);

public static Microsoft.AspNetCore.Html.IHtmlContent DropDownList (this Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper htmlHelper, string expression);

static member DropDownList : Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper * string -> Microsoft.AspNetCore.Html.IHtmlContent

<Extension()>
Public Function DropDownList (htmlHelper As IHtmlHelper, expression As String) As IHtmlContent

參數

htmlHelper

IHtmlHelper

這個 IHtmlHelper 方法擴充的實例。

expression

String

相對於目前模型的運算式名稱。

傳回

IHtmlContent

新的 IHtmlContent ，其中包含 < select > 元素。

備註

HtmlFieldPrefix結合 和 expression 以設定 < select > 元素的 「name」 屬性。 清理 expression 以設定元素的 「id」 屬性。

ViewData具有完整名稱的專案 SelectListItem 必須是非 null 物件的集合。

DropDownList(IHtmlHelper, String, IEnumerable<SelectListItem>)

來源:

HtmlHelperSelectExtensions.cs

傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 selectList 新增 < 選項 > 專案。 如果 Value (非 null) 或 Text 符合中找到的第一個非 null 值，則會將 「selected」 屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案、 ViewData 具有完整名稱的專案 (，除非使用 selectList 而非) ，否則 expression 會針對 Model 進行評估。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::AspNetCore::Html::IHtmlContent ^ DropDownList(Microsoft::AspNetCore::Mvc::Rendering::IHtmlHelper ^ htmlHelper, System::String ^ expression, System::Collections::Generic::IEnumerable<Microsoft::AspNetCore::Mvc::Rendering::SelectListItem ^> ^ selectList);

public static Microsoft.AspNetCore.Html.IHtmlContent DropDownList (this Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper htmlHelper, string expression, System.Collections.Generic.IEnumerable<Microsoft.AspNetCore.Mvc.Rendering.SelectListItem> selectList);

static member DropDownList : Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper * string * seq<Microsoft.AspNetCore.Mvc.Rendering.SelectListItem> -> Microsoft.AspNetCore.Html.IHtmlContent

<Extension()>
Public Function DropDownList (htmlHelper As IHtmlHelper, expression As String, selectList As IEnumerable(Of SelectListItem)) As IHtmlContent

參數

htmlHelper

IHtmlHelper

這個 IHtmlHelper 方法擴充的實例。

expression

String

相對於目前模型的運算式名稱。

selectList

IEnumerable<SelectListItem>

物件的集合 SelectListItem ，用來以 optgroup > 和 < option > 元素填入 < select > 元素 < 。 如果 null 為 ，則使用 ViewData 具有完整名稱的專案，而且該專案必須是 物件的集合 SelectListItem 。

傳回

IHtmlContent

新的 IHtmlContent ，其中包含 < select > 元素。

備註

HtmlFieldPrefix結合 和 expression 以設定 < select > 元素的 「name」 屬性。 清理 expression 以設定元素的 「id」 屬性。

DropDownList(IHtmlHelper, String, String)

來源:

HtmlHelperSelectExtensions.cs

傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 optionLabel 和 ViewData 具有完整名稱的專案，加入 < 選項 > 專案。 如果 Value (非 Textnull) 或符合中找到的第一個非 null 值，則將其 「選取」屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案，或 expression 針對 進行評估的 Model 。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::AspNetCore::Html::IHtmlContent ^ DropDownList(Microsoft::AspNetCore::Mvc::Rendering::IHtmlHelper ^ htmlHelper, System::String ^ expression, System::String ^ optionLabel);

public static Microsoft.AspNetCore.Html.IHtmlContent DropDownList (this Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper htmlHelper, string expression, string optionLabel);

static member DropDownList : Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper * string * string -> Microsoft.AspNetCore.Html.IHtmlContent

<Extension()>
Public Function DropDownList (htmlHelper As IHtmlHelper, expression As String, optionLabel As String) As IHtmlContent

參數

htmlHelper

IHtmlHelper

這個 IHtmlHelper 方法擴充的實例。

expression

String

相對於目前模型的運算式名稱。

optionLabel

String

預設空白項目的文字。 如果引數為 null ，則不包含這類專案。

傳回

IHtmlContent

新的 IHtmlContent ，其中包含 < select > 元素。

備註

HtmlFieldPrefix結合 和 expression 以設定 < select > 元素的 「name」 屬性。 清理 expression 以設定元素的 「id」 屬性。

ViewData具有完整名稱的專案 SelectListItem 必須是非 null 物件的集合。

DropDownList(IHtmlHelper, String, IEnumerable<SelectListItem>, Object)

來源:

HtmlHelperSelectExtensions.cs

傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 selectList 新增 < 選項 > 專案。 如果 Value (非 null) 或 Text 符合中找到的第一個非 null 值，則會將 「selected」 屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案、 ViewData 具有完整名稱的專案 (，除非使用 selectList 而非) ，否則 expression 會針對 Model 進行評估。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::AspNetCore::Html::IHtmlContent ^ DropDownList(Microsoft::AspNetCore::Mvc::Rendering::IHtmlHelper ^ htmlHelper, System::String ^ expression, System::Collections::Generic::IEnumerable<Microsoft::AspNetCore::Mvc::Rendering::SelectListItem ^> ^ selectList, System::Object ^ htmlAttributes);

public static Microsoft.AspNetCore.Html.IHtmlContent DropDownList (this Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper htmlHelper, string expression, System.Collections.Generic.IEnumerable<Microsoft.AspNetCore.Mvc.Rendering.SelectListItem> selectList, object htmlAttributes);

static member DropDownList : Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper * string * seq<Microsoft.AspNetCore.Mvc.Rendering.SelectListItem> * obj -> Microsoft.AspNetCore.Html.IHtmlContent

<Extension()>
Public Function DropDownList (htmlHelper As IHtmlHelper, expression As String, selectList As IEnumerable(Of SelectListItem), htmlAttributes As Object) As IHtmlContent

參數

htmlHelper

IHtmlHelper

這個 IHtmlHelper 方法擴充的實例。

expression

String

相對於目前模型的運算式名稱。

selectList

IEnumerable<SelectListItem>

物件的集合 SelectListItem ，用來以 optgroup > 和 < option > 元素填入 < select > 元素 < 。 如果 null 為 ，則使用 ViewData 具有完整名稱的專案，而且該專案必須是 物件的集合 SelectListItem 。

htmlAttributes

Object

Object，包含 select > 元素的 < HTML 屬性。 或者， IDictionary<TKey,TValue> 包含 HTML 屬性的實例。

傳回

IHtmlContent

新的 IHtmlContent ，其中包含 < select > 元素。

備註

HtmlFieldPrefix結合 和 expression 以設定 < select > 元素的 「name」 屬性。 清理 expression 以設定元素的 「id」 屬性。

DropDownList(IHtmlHelper, String, IEnumerable<SelectListItem>, String)

來源:

HtmlHelperSelectExtensions.cs

傳回 的單一選取 HTML < 選取 > 專案 expression 。 根據 optionLabel 和 selectList 加入 < 選項 > 專案。 如果 Value (非 null) 或 Text 符合中找到的第一個非 null 值，則會將 「selected」 屬性 < 加入至選項 > ： ModelState 具有完整名稱的專案、 ViewData 具有完整名稱的專案 (，除非使用 selectList 而非) ，否則 expression 會針對 Model 進行評估。 如需有關「完整名稱」的詳細資訊，請參閱 Name(String) 。

public:
[System::Runtime::CompilerServices::Extension]
 static Microsoft::AspNetCore::Html::IHtmlContent ^ DropDownList(Microsoft::AspNetCore::Mvc::Rendering::IHtmlHelper ^ htmlHelper, System::String ^ expression, System::Collections::Generic::IEnumerable<Microsoft::AspNetCore::Mvc::Rendering::SelectListItem ^> ^ selectList, System::String ^ optionLabel);

public static Microsoft.AspNetCore.Html.IHtmlContent DropDownList (this Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper htmlHelper, string expression, System.Collections.Generic.IEnumerable<Microsoft.AspNetCore.Mvc.Rendering.SelectListItem> selectList, string optionLabel);

static member DropDownList : Microsoft.AspNetCore.Mvc.Rendering.IHtmlHelper * string * seq<Microsoft.AspNetCore.Mvc.Rendering.SelectListItem> * string -> Microsoft.AspNetCore.Html.IHtmlContent

<Extension()>
Public Function DropDownList (htmlHelper As IHtmlHelper, expression As String, selectList As IEnumerable(Of SelectListItem), optionLabel As String) As IHtmlContent

參數

htmlHelper

IHtmlHelper

這個 IHtmlHelper 方法擴充的實例。

expression

String

相對於目前模型的運算式名稱。

selectList

IEnumerable<SelectListItem>

物件的集合 SelectListItem ，用來以 optgroup > 和 < option > 元素填入 < select > 元素 < 。 如果 null 為 ，則使用 ViewData 具有完整名稱的專案，而且該專案必須是 物件的集合 SelectListItem 。

optionLabel

String

預設空白項目的文字。 如果引數為 null ，則不包含這類專案。

傳回

IHtmlContent

新的 IHtmlContent ，其中包含 < select > 元素。

備註

HtmlFieldPrefix結合 和 expression 以設定 < select > 元素的 「name」 屬性。 清理 expression 以設定元素的 「id」 屬性。