FormView.ChangeMode Method

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
)
Not applicable.

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 Server 2000 SP4, 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

Community Additions

ADD
Show: