ObjectList.ViewMode Property

Reference

Definition

Namespace:: System.Web.UI.MobileControls

Assembly:: System.Web.Mobile.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the view mode of an ObjectList. This API is obsolete. For information about how to develop ASP.NET mobile applications, see Mobile Apps & Sites with ASP.NET.

public:
 property System::Web::UI::MobileControls::ObjectListViewMode ViewMode { System::Web::UI::MobileControls::ObjectListViewMode get(); void set(System::Web::UI::MobileControls::ObjectListViewMode value); };

[System.ComponentModel.Bindable(false)]
[System.ComponentModel.Browsable(false)]
public System.Web.UI.MobileControls.ObjectListViewMode ViewMode { get; set; }

[<System.ComponentModel.Bindable(false)>]
[<System.ComponentModel.Browsable(false)>]
member this.ViewMode : System.Web.UI.MobileControls.ObjectListViewMode with get, set

Public Property ViewMode As ObjectListViewMode

Property Value

ObjectListViewMode

An ObjectListViewMode value representing the view mode of the object list.

Attributes: BindableAttribute BrowsableAttribute

Exceptions

Exception

An attempt was made to set this property to a value other than List while no item was selected.

Remarks

The following options are available for this property through the ObjectListViewMode enumeration.

Member Name	Description
List	This is the default view displayed when the page containing the object list is rendered for the first time. It consists of either the label fields of the items, or if the TableFields property is not empty, a table with columns corresponding to the table fields and rows for the items. In HTML, this view is combined with the Commands view, with the commands appearing as hyperlinks below the list. When there is more information in the Details view, a hyperlink for each item displaying the Details view is rendered.
Details	In HTML, this view is combined with the Commands view, with the commands appearing as hyperlinks below the details.
Commands	This view is rendered separately only for WML devices. It consists of a menu with the commands of the ObjectList. For HTML devices, the List view and Details view are each combined with this view, with the commands appearing as hyperlinks below the details or list.

Note

To set this property in code, an item in the list must be selected before setting this property to Commands or Details view. An attempt to set the property before selecting an item throws an exception.

A view mode is persisted in a private view state, so that, regardless of whether the EnableViewState property of the ObjectList object is true, the view mode is persisted as a private field. However, if the EnableViewState property is false, the items collection is not persisted between requests, requiring a data bind to be repeated for each request.

Applies to

Jaa