The List control allows you to display a list of static strings or text links. These items can be added declaratively (through the .aspx file or configured with the property designer in Visual Studio .NET), or they can be added and examined programmatically through the Items property. This property provides a collection of MobileListItem instances, each of which can define visible text (MobileListItem.Text) and a non-visible value (MobileListItem.Value). In addition, the List control supports data binding. You simply need to set the DataSource property to a valid data source (like an System.Collections.ArrayList, System.Data.DataTable, or System.Data.DataView), and then specify the properties or fields to bind using the DataTextField and DataValueField properties.

You can apply bullets or automatic numbering to the list items using the Decoration property, and you can use the properties inherited from the base PagedControl class to split the list over multiple mobile pages. To specify that the items should be rendered as hyperlinks, set the ItemsAsLinks to True. When the user clicks an item, the ItemCommand event will be fired with information about the source item.

public class List : PagedControl, System.Web.UI.INamingContainer, IListControl, ITemplateable, 
        System.Web.UI.IPostBackEventHandler {
// Public Constructors
   public List( );
// Public Instance Properties
   public virtual string DataMember{set; get; }
   public virtual object DataSource{set; get; }
   public string DataTextField{set; get; }
   public string DataValueField{set; get; }
   public ListDecoration Decoration{set; get; }
   public bool HasItemCommandHandler{get; }
   public MobileListItemCollection Items{get; }
   public bool ItemsAsLinks{set; get; }
// Protected Instance Properties
   protected override int InternalItemCount{get; }               // overrides PagedControl
// Public Instance Methods
   public override void CreateDefaultTemplatedUI(bool doDataBind);                // overrides MobileControl
   public override void EnsureTemplatedUI( );        // overrides MobileControl
// Protected Instance Methods
   protected override void AddParsedSubObject(object obj);      // overrides MobileControl
   protected override void CreateChildControls( );                // overrides System.Web.UI.Control
   protected virtual void CreateItems(System.Collections.IEnumerable dataSource);
   protected override void EnsureChildControls( );                // overrides System.Web.UI.Control
   protected override void LoadViewState(object savedState);    // overrides MobileControl
   protected override bool OnBubbleEvent(object sender, EventArgs e); // overrides System.Web.UI.Control
   protected override void OnDataBinding(EventArgs e);          // overrides MobileControl
   protected virtual void OnItemCommand(ListCommandEventArgs e);
   protected virtual void OnItemDataBind(ListDataBindEventArgs e); // implements IListControl
   protected override void OnLoadItems(LoadItemsEventArgs e);    // overrides PagedControl
   protected override void OnPageChange(int oldPageIndex, int newPageIndex); // overrides PagedControl
   protected override void OnPreRender(EventArgs e);            // overrides PagedControl
   protected override object SaveViewState( );       // overrides MobileControl
   protected override void TrackViewState( );        // overrides MobileControl
// Events
   public event ListCommandEventHandler ItemCommand;
   public event ListDataBindEventHandler ItemDataBind;
}

Hierarchy

System.Object System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) MobileControl(System.Web.UI.IAttributeAccessor) PagedControl List(System.Web.UI.INamingContainer, IListControl, ITemplateable, System.Web.UI.IPostBackEventHandler)

Returned By

System.Web.UI.MobileControls.Adapters.HtmlListAdapter.Control, System.Web.UI.MobileControls.Adapters.WmlListAdapter.Control