FormView.ChangeMode Method (FormViewMode)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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

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

member ChangeMode : 
        newMode:FormViewMode -> unit

Parameters

newMode
Type: System.Web.UI.WebControls.FormViewMode

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.

System_CAPS_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.

.NET Framework
Available since 2.0
Return to top
Show: