The ObjectList control is a data-bound list that allows you to display multiple pieces of information from System.Data.DataRow objects in a System.Data.DataTable, or any other type of object in a collection. Unlike the simpler List control, you cannot directly add items to or remove items from an ObjectList. Instead, you must set the DataSource property and call the DataBind( ) method.
The appearance of the ObjectList depends on the type of mobile device and the control property settings. Usually, the ObjectList appears as a single list of values drawn from the data-bound object. For example, if you are binding a table of customers, you might configure the ObjectList to display a list of customer IDs by setting the LabelField property to "ID". The user can then select the ID (on a WML browser) or click the "More" link (on an HTML browser) to show the full item information and any item-specific commands you have defined. You can specify the fields that will be shown in the detailed view in one of two ways. If you set AutoGenerateFields to True, all the fields (or public properties) will be shown for the bound objects. Alternatively, set AutoGenerateFields to False and add a collection of ObjectListField instances (one for each field or property you want to bind) to the Fields collection. In addition, you can configure the rendering of the control so that it creates a table that shows multiple fields for each item. This is only supported for HTML devices. To enable this behavior, set the TableFields to a list of property or field names separated by semicolons (as in "ID;FirstName;LastName").
The ObjectList also allows you to define commands that can be invoked for any item in the list. You can define these commands by adding ObjectListCommand instances to the Commands collection. Visual Studio .NET provides rich designer support for the ObjectList control, including a property builder that allows you to specify bound columns and define list commands.
public class ObjectList : PagedControl, System.Web.UI.INamingContainer, ITemplateable, System.Web.UI.IPostBackEventHandler { // Public Constructors public ObjectList( ); // Public Static Properties public static string SelectMoreCommand{get; } // Public Instance Properties public IObjectListFieldCollection AllFields{get; } public bool AutoGenerateFields{set; get; } public string BackCommandText{set; get; } public virtual ObjectListCommandCollection Commands{get; } public Style CommandStyle{set; get; } public virtual string DataMember{set; get; } public virtual object DataSource{set; get; } public string DefaultCommand{set; get; } public Panel Details{get; } public string DetailsCommandText{set; get; } public virtual ObjectListFieldCollection Fields{get; } public bool HasItemCommandHandler{get; } public virtual ObjectListItemCollection Items{get; } public string LabelField{set; get; } public int LabelFieldIndex{get; } public Style LabelStyle{set; get; } public string MoreText{set; get; } public int SelectedIndex{set; get; } public ObjectListItem Selection{get; } public int[ ] TableFieldIndices{get; } public string TableFields{set; get; } public ObjectListViewMode ViewMode{set; get; } // Protected Instance Properties protected override int InternalItemCount{get; } // overrides PagedControl // Public Instance Methods public void CreateTemplatedItemDetails(bool doDataBind); public void CreateTemplatedItemsList(bool doDataBind); public override void DataBind( ); // overrides System.Web.UI.Control public override void EnsureTemplatedUI( ); // overrides MobileControl public void PreShowItemCommands(int itemIndex); public void RaiseDefaultItemEvent(int itemIndex); public bool SelectListItem(int itemIndex, bool selectMore); // Protected Instance Methods protected override void AddParsedSubObject(object obj); // overrides MobileControl protected void CreateAutoGeneratedFields(System.Collections.IEnumerable dataSource); protected override void CreateChildControls( ); // overrides System.Web.UI.Control protected virtual ObjectListItem CreateItem(object dataItem); protected virtual void CreateItems(System.Collections.IEnumerable dataSource); protected override void EnsureChildControls( ); // overrides System.Web.UI.Control protected override void LoadPrivateViewState(object state); // overrides PagedControl 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(ObjectListCommandEventArgs e); protected virtual void OnItemDataBind(ObjectListDataBindEventArgs e); protected virtual void OnItemSelect(ObjectListSelectEventArgs e); protected override void OnLoadItems(LoadItemsEventArgs e); // overrides PagedControl protected override void OnPreRender(EventArgs e); // overrides PagedControl protected virtual void OnShowItemCommands(ObjectListShowCommandsEventArgs e); protected override object SavePrivateViewState( ); // overrides PagedControl protected override object SaveViewState( ); // overrides MobileControl protected override void TrackViewState( ); // overrides MobileControl // Events public event ObjectListCommandEventHandler ItemCommand; public event ObjectListDataBindEventHandler ItemDataBind; public event ObjectListSelectEventHandler ItemSelect; public event ObjectListShowCommandsEventHandler ShowItemCommands; }
System.Web.UI.Control(System.ComponentModel.IComponent, System.IDisposable, System.Web.UI.IParserAccessor, System.Web.UI.IDataBindingsAccessor) 