ASP.NET.in.a.Nutshell.Second.Edition [Electronic resources] نسخه متنی

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)