ObjectList.ViewMode Property

Gets or sets the view mode of an ObjectList.

Namespace: System.Web.UI.MobileControls
Assembly: System.Web.Mobile (in system.web.mobile.dll)

public ObjectListViewMode ViewMode { get; set; }
/** @property */
public ObjectListViewMode get_ViewMode ()

/** @property */
public void set_ViewMode (ObjectListViewMode value)

public function get ViewMode () : ObjectListViewMode

public function set ViewMode (value : ObjectListViewMode)

Not applicable.

Property Value

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

Exception typeCondition


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

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

Member Name



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.


In HTML, this view is combined with the Commands view, with the commands appearing as hyperlinks below the details.


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.


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.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1

Community Additions