ASP.NET in a Nutshell

Name

ListControl

Synopsis

This abstract base class for all list controls includes data-binding functionality (such as DataTextFormatString, which specifies the formatting of bound text), an Items collection, and properties for returning the first selected item (SelectedIndex and SelectedItem).

Note that items in the ListControl class do not correspond to the specific derived control type. For example, a CheckBoxList control returns its selected item as a ListItem, as all list controls do, not as an individual checkbox control.

Public MustInherit Class ListControl : Inherits WebControl
' Public Constructors
   Public Sub New() 
' Public Instance Properties
   Overridable Public Property AutoPostBack As Boolean  
   Overridable Public Property DataMember As String  
   Overridable Public Property DataSource As Object  
   Overridable Public Property DataTextField As String  
   Overridable Public Property DataTextFormatString As String  
   Overridable Public Property DataValueField As String  
   Overridable Public ReadOnly Property Items As ListItemCollection  
   Overridable Public Property SelectedIndex As Integer  
   Overridable Public ReadOnly Property SelectedItem As ListItem  
' Public Instance Methods
   Overridable Public Sub ClearSelection() 
' Protected Instance Methods
   Overrides Protected Sub LoadViewState(
        ByVal savedState As Object) 
   Overrides Protected Sub OnDataBinding(ByVal e As EventArgs) 
   Overrides Protected Sub OnPreRender(ByVal e As EventArgs) 
   Overridable Protected Sub OnSelectedIndexChanged( ByVal e As EventArgs) ...