FormView.ChangeMode Method

Note: This method is new in the .NET Framework version 2.0.

Switches the FormView control to the specified data-entry mode.

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

public:
void ChangeMode (
	FormViewMode newMode
)
public void ChangeMode (
	FormViewMode newMode
)
public function ChangeMode (
	newMode : FormViewMode
)

Parameters

newMode

One of the FormViewMode enumeration values.

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

Mode

Description

FormViewMode.Edit

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

FormViewMode.Insert

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

FormView.ReadOnly

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

NoteNote

The ModeChanged and ModeChanging events are not raised when this method is called.

The following example demonstrates how to use the ChangeMode method to return the FormView 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.

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

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

.NET Framework

Supported in: 2.0

Community Additions

ADD
Show: