This documentation is archived and is not being maintained.

DetailsView::ChangeMode Method

Switches the DetailsView control to the specified mode.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public:
void ChangeMode(
	DetailsViewMode newMode
)

Parameters

newMode
Type: System.Web.UI.WebControls::DetailsViewMode
One of the DetailsViewMode values.

Use the ChangeMode method to programmatically switch the DetailsView control between edit, insert, and read-only mode. This method also updates the CurrentMode property with the specified mode. The following table lists the different mode values.

Mode

Description

DetailsViewMode.Edit

The DetailsView control is in edit mode, which allows the user to update the values of a record.

DetailsViewMode.Insert

The DetailsView control is in insert mode, which allows the user to add a new record to the data source.

DetailsView.ReadOnly

The DetailsView control is in read-only mode, which is the normal display mode.

The following code example demonstrates how to use the ChangeMode method to return the DetailsView control to read-only mode whenever the user navigates to another record.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: