DetailsViewInsertedEventArgs.KeepInInsertMode Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value indicating whether the DetailsView control should remain in insert mode after an insert operation.

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

public bool KeepInInsertMode { get; set; }
/** @property */
public boolean get_KeepInInsertMode ()

/** @property */
public void set_KeepInInsertMode (boolean value)

public function get KeepInInsertMode () : boolean

public function set KeepInInsertMode (value : boolean)

Property Value

true to remain in insert mode after an insert operation; otherwise, false. The default is false.

By default, the DetailsView control returns to the mode specified by the DefaultMode property. Use the KeepInInsertMode property to specify whether the DetailsView control should remain in insert mode after an insert operation. To keep the DetailsView control in insert mode, set this property to true.


This property should be used when you want to want to override the default mode only occasionally. If the DetailsView control needs to remain in insert mode by default, set the DefaultMode property instead.

The following code example demonstrates how to use the KeepInInsertMode property to keep the DetailsView control in insert mode after an insert operation.

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

<script runat="server">

  void CustomerDetailsView_ItemInserted(Object sender, 
    DetailsViewInsertedEventArgs e)
    // Use the Exception property to determine whether an exception
    // occurred during the insert operation.
    if (e.Exception == null && e.AffectedRows == 1)
      // Use the Values property to get the value entered by 
      // the user for the CompanyName field.
      String name = e.Values["CompanyName"].ToString();

      // Display a confirmation message.
      MessageLabel.Text = name + " added successfully. ";

      // Insert the code to handle the exception.
      MessageLabel.Text = e.Exception.Message;
      // Use the ExceptionHandled property to indicate that the 
      // exception is already handled.
      e.ExceptionHandled = true;
      // When an exception occurs, keep the DetailsView
      // control in insert mode.
      e.KeepInInsertMode = true;


    <form runat="server">
      <h3>DetailsViewInsertedEventArgs Example</h3>
        <asp:detailsview id="CustomerDetailsView"
          <fieldheaderstyle backcolor="Navy"
        <asp:label id="MessageLabel"
        <!-- 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"
          selectcommand="Select [CustomerID], [CompanyName], [Address], 
            [City], [PostalCode], [Country] From [Customers]"
          insertcommand="INSERT INTO [Customers]([CustomerID], 
            [CompanyName], [Address], [City], [PostalCode], 
            [Country]) VALUES (@CustomerID, @CompanyName, @Address, 
            @City, @PostalCode, @Country)"
            "<%$ ConnectionStrings:NorthWindConnectionString%>" 

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0

Community Additions