HtmlSelect

HtmlSelectdisposable

System.Web.UI.HtmlControls (system.web.dll)class

This class represents the HTML <select> tag, which allows the user to choose an option from a drop-down list box. To add an item to the list, use the Add( ) method of the Items property. The HtmlSelect control also supports data binding to its Items property.

To retrieve the currently selected item, you can use SelectedIndex property to find the ordinal number of the chosen item (-1 if no selection has been made), or the Value property to retrieve the text of the selected item. If you have set Multiple to True, more than one item may be selected and only the first item will be returned by the SelectedIndex and Value properties. Instead, you will have to iterate through the Items collection and check the System.Web.UI.WebControls.ListItem.Selected property for each one.

You can also react to the ServerChange event, which will fire only after a postback is triggered (for example, when the user clicks a submit button).

public class HtmlSelect : HtmlContainerControl, System.Web.UI.IPostBackDataHandler { // Public Constructors    public HtmlSelect( ); // Public Instance Properties    public virtual string DataMember{set; get; }    public virtual object DataSource{set; get; }    public virtual string DataTextField{set; get; }    public virtual string DataValueField{set; get; }    public override string InnerHtml{set; get; }                  // overrides HtmlContainerControl    public override string InnerText{set; get; }                  // overrides HtmlContainerControl    public ListItemCollection Items{get; }    public bool Multiple{set; get; }    public string Name{set; get; }    public virtual int SelectedIndex{set; get; }    public int Size{set; get; }    public string Value{set; get; } // Protected Instance Properties    protected virtual int[ ] SelectedIndices{get; } // Protected Instance Methods    protected override void AddParsedSubObject(object obj);      // overrides System.Web.UI.Control    protected virtual void ClearSelection( );    protected override ControlCollection CreateControlCollection( ); // overrides HtmlContainerControl    protected override void LoadViewState(object savedState);    // overrides HtmlContainerControl    protected override void OnDataBinding(EventArgs e);          // overrides System.Web.UI.Control    protected override void OnPreRender(EventArgs e);            // overrides System.Web.UI.Control    protected virtual void OnServerChange(EventArgs e);    protected override void RenderAttributes(System.Web.UI.HtmlTextWriter writer); // overrides HtmlContainerControl    protected override void RenderChildren(System.Web.UI.HtmlTextWriter writer); // overrides System.Web.UI.Control    protected override object SaveViewState( );       // overrides System.Web.UI.Control    protected virtual void Select(int[ ] selectedIndices);    protected override void TrackViewState( );        // overrides System.Web.UI.Control // Events    public event EventHandler ServerChange; }

Hierarchy

System.Object System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) HtmlControl(System.Web.UI.IAttributeAccessor) HtmlContainerControl HtmlSelect(System.Web.UI.IPostBackDataHandler)



ASP. NET in a Nutshell
ASP.NET in a Nutshell, Second Edition
ISBN: 0596005202
EAN: 2147483647
Year: 2003
Pages: 873

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net