DetailsView::CurrentMode Property
Gets the current data-entry mode of the DetailsView control.
Assembly: System.Web (in System.Web.dll)
Use the CurrentMode property to determine whether the DetailsView control is in edit, insert, or read-only 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. |
DetailsViewMode.ReadOnly | The DetailsView control is in read-only mode, which is the normal display mode. |
This value is normally set automatically by the DetailsView control by when the New, Update, Insert, Delete, or Cancel command button is clicked. You can also programmatically change the mode by using the ChangeMode method.
When the DetailsView control changes modes, the events in the following table are raised. This allows you to create a custom event handler that performs a routine when the event occurs.
Event | Description |
|---|---|
Occurs when a command button that changes the mode of the DetailsView control is clicked, but after the mode changes. | |
Occurs when a command button that changes the mode of the DetailsView control is clicked, but before the mode changes. |
The following code example demonstrates how to use the CurrentMode property to determine whether the DetailsView control is in edit, insert, or read-only mode. If the user attempts to navigate to a different record while the DetailsView control is in edit mode, the paging operation is canceled.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.