DetailsView.ChangeMode(DetailsViewMode) Method

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Switches the DetailsView control to the specified mode.

public:
 void ChangeMode(System::Web::UI::WebControls::DetailsViewMode newMode);

public void ChangeMode(System.Web.UI.WebControls.DetailsViewMode newMode);

member this.ChangeMode : System.Web.UI.WebControls.DetailsViewMode -> unit

Public Sub ChangeMode (newMode As DetailsViewMode)

Parameters

newMode: DetailsViewMode

One of the DetailsViewMode values.

Examples

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.


<%@ Page language="C#" %>





  
    DetailsView ChangeMode Example


    
        
      DetailsView ChangeMode Example


<%@ Page language="VB" %>





  
    DetailsView ChangeMode Example


    
        
      DetailsView ChangeMode Example

Remarks

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.

Applies to

Feedback

Was this page helpful?