DetailsView.DefaultMode Property
Get or sets the default data-entry mode of the DetailsView control.
Assembly: System.Web (in System.Web.dll)
Property Value
Type: System.Web.UI.WebControls.DetailsViewModeOne of the DetailsViewMode values. The default is DetailsViewMode.ReadOnly.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | The specified value is not one of the DetailsViewMode enumeration values. |
Use the DefaultMode property to specify whether the DetailsView control returns to edit, insert, or read-only mode after an edit or insert operation is performed. By default, the DetailsView control returns to read-only mode; however, you can keep the DetailsView control in edit or insert mode by setting this property to the appropriate value. 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. |
The following code example demonstrates how to use the DefaultMode property to specify that the DetailsView control should remain in edit mode after a record has been updated.
<%@ Page language="C#" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>DetailsView DefaultMode Example</title> </head> <body> <form id="Form1" runat="server"> <h3>DetailsView DefaultMode Example</h3> <asp:detailsview id="CustomerDetailView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogenerateeditbutton="true" autogeneraterows="true" allowpaging="true" defaultmode="Edit" runat="server"> <headerstyle backcolor="Navy" forecolor="White"/> </asp:detailsview> <!-- This example uses Microsoft SQL Server and connects --> <!-- to the Northwind sample database. Use an ASP.NET --> <!-- expression to retrieve the connection string value --> <!-- from the web.config file. --> <asp:SqlDataSource ID="DetailsViewSource" runat="server" ConnectionString= "<%$ ConnectionStrings:NorthWindConnectionString%>" InsertCommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)" SelectCommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"> </asp:SqlDataSource> </form> </body> </html>
Available since 2.0