HtmlHelper.CheckBox Method (String, Boolean, IDictionary<String, Object>)
Returns an HTML check box control that has the specified name, default checked status, and custom attributes defined by an attribute dictionary.
Namespace: System.Web.WebPages.Html
Assembly: System.Web.WebPages (in System.Web.WebPages.dll)
Syntax
'Declaration
Public Function CheckBox ( _
name As String, _
isChecked As Boolean, _
htmlAttributes As IDictionary(Of String, Object) _
) As IHtmlString
'Usage
Dim instance As HtmlHelper
Dim name As String
Dim isChecked As Boolean
Dim htmlAttributes As IDictionary(Of String, Object)
Dim returnValue As IHtmlString
returnValue = instance.CheckBox(name, _
isChecked, htmlAttributes)
public IHtmlString CheckBox(
string name,
bool isChecked,
IDictionary<string, Object> htmlAttributes
)
public:
IHtmlString^ CheckBox(
String^ name,
bool isChecked,
IDictionary<String^, Object^>^ htmlAttributes
)
member CheckBox :
name:string *
isChecked:bool *
htmlAttributes:IDictionary<string, Object> -> IHtmlString
public function CheckBox(
name : String,
isChecked : boolean,
htmlAttributes : IDictionary<String, Object>
) : IHtmlString
Parameters
- name
Type: System.String
The value to assign to the name attribute of the HTML control element.
- isChecked
Type: System.Boolean
true to indicate that the checked attribute is set to checked; otherwise, false.
- htmlAttributes
Type: System.Collections.Generic.IDictionary<String, Object>
The names and values of custom attributes for the element.
Return Value
Type: System.Web.IHtmlString
The HTML markup that represents the check box control.
Exceptions
| Exception | Condition |
|---|---|
| ArgumentException | name is null reference (Nothing in Visual Basic) or empty. |
Remarks
The returned markup consists of an HTML input element in one of the following forms:
<input type="checkbox" name="name" checked="checked" ...htmlAttributes... /> |
isChecked is true. |
<input type="checkbox" name="name" ...htmlAttributes... /> |
isChecked is false. |