HtmlSelect.ClearSelection Method ()
.NET Framework (current version)
Clears the list selection of the HtmlSelect control and sets the ListItem.Selected property of all items to false.
Assembly: System.Web (in System.Web.dll)
The ClearSelection method iterates through the ListItemCollection collection represented by the HtmlSelect control's Items property and sets the Selected property of each ListItem object to false.
The following code example demonstrates how to override the ClearSelection method in a custom server control so that it always clears all selected items of an HtmlSelect collection.
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %> <%@ Page Language="C#" AutoEventWireup="True" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head> <title>Custom HtmlSelect - ClearSelection - C# Example</title> <script runat="server"> void HtmlInputButton1_ServerClick(Object sender, EventArgs e) { if (HtmlSelect1.SelectedIndex >= 0) { if (HtmlSelect1.Multiple == true) { Div1.InnerHtml = "You selected:"; for (int i=0; i<=HtmlSelect1.Items.Count - 1; i++) { if (HtmlSelect1.Items[i].Selected == true) { Div1.InnerHtml += "<br /> " + HtmlSelect1.Items[i].Value; } } } else { Div1.InnerHtml = "You selected " + HtmlSelect1.Value; } } else { Div1.InnerHtml = "You did not select an item."; } } </script> </head> <body> <form id="Form1" method="post" runat="server"> <h3>Custom HtmlSelect - ClearSelection - C# Example</h3> <p> <aspSample:CustomHtmlSelectClearSelection id="HtmlSelect1" multiple name="HtmlSelect1" runat="server"> <option value="Option1">Option1</option> <option value="Option2">Option2</option> <option value="Option3">Option3</option> <option value="Option4">Option4</option> </aspSample:CustomHtmlSelectClearSelection> </p> <p> <input id="HtmlInputButton1" runat="server" type="button" onserverclick="HtmlInputButton1_ServerClick" value="Select" name="HtmlInputButton1" /> </p> <br /> <div id="Div1" runat="server" style="DISPLAY: inline; WIDTH: 256px; HEIGHT: 15px" /> </form> </body> </html>
using System.Web; using System.Security.Permissions; namespace Samples.AspNet.CS.Controls { [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)] public sealed class CustomHtmlSelectClearSelection : System.Web.UI.HtmlControls.HtmlSelect { protected override void ClearSelection() { // For each item in the Items collection, // set the Selected property to false. for (int i=0; i < Items.Count; i++) Items[i].Selected = false; } } }
.NET Framework
Available since 1.1
Available since 1.1
Show: