System.Web.UI.WebControls.DetailsViewMode Enumeration

Represents the different data-entry modes of a System.Web.UI.WebControls.DetailsView control.

Syntax

public enum DetailsViewMode

Remarks

The System.Web.UI.WebControls.DetailsViewMode enumeration is used to represent the data-entry modes of a System.Web.UI.WebControls.DetailsView control. To determine the current mode of the control, use the DetailsView.CurrentMode property. After an insert or update operation, the System.Web.UI.WebControls.DetailsView control returns to the mode specified by the DetailsView.DefaultMode property. By default, the control returns to read-only mode. You can specify an alternate mode to return to by setting the DetailsView.DefaultMode property. To change modes programmatically, use the DetailsView.ChangeMode(DetailsViewMode) method. When the System.Web.UI.WebControls.DetailsView control changes modes, the events in the following table are raised.

DetailsView.ModeChanging

Occurs when a System.Web.UI.WebControls.DetailsView control attempts to change between edit, insert, and read-only mode, but before the mode actually changes. This event is often used to cancel a mode change.

DetailsView.ModeChanged

Occurs after a System.Web.UI.WebControls.DetailsView control has changed from edit, insert, or read-only mode to another mode. This event is often used to perform a task when the System.Web.UI.WebControls.DetailsView control changes modes.

Members

Member NameDescription
Edit

An editing mode that allows the user to update the values of an existing record.

Insert

An inserting mode that allows the user to enter the values for a new record.

ReadOnly

A display mode that prevents the user from modifying the values of a record.

Requirements

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in System.Web.dll)
Assembly Versions: 2.0.0.0
Since: .NET 2.0