Log In
[Expand]General Information
[Collapse]WinForms Controls
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Collapse]Data Grid
   [Expand]Getting Started
   [Expand]Binding to Data
   [Expand]Grid View
   [Expand]View Technology
   [Collapse]Data Editing
    [Expand]Edit Form
    [Expand]Editing via Code
    [Expand]In-place Editors
    [Expand]Input Validation
    [Collapse]New Item Row
      New Item Row Overview
     Tutorial: Add or Remove Rows
     Tutorial: Data Input Validation
   [Expand]Filtering and Locating Rows
   [Expand]Focus and Selection Handling
   [Expand]Processing Rows
   [Expand]Formatting Cell Values
   [Expand]Master-Detail Relationships
   [Expand]Asynchronous Image Load
   [Expand]Export and Printing
   [Expand]Appearance and Conditional Formatting
   [Expand]Batch Modifications
   [Expand]Hit Information
   [Expand]Popup Menus
   [Expand]Saving and Restoring Layouts
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Included Components
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Map Control
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Report Server
[Expand]eXpressApp Framework
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

New Item Row Overview

This topic describes the new item row - a row that allows end-users to add new records. Note that this row can only be used if the data source supports the addition of new rows (for instance, when your data source implements the IBindingList interface and the IBindingList.AllowNew property value is true).

Expanded Online Video

  • Add or Remove Rows
    This video describes the Grid Control UI elements and API that enable you and end-users to add or remove data rows. You will first learn how to enable the built-in Data Navigator, and then, how to use the Microsoft Outlook inspired New Item Row to add new records. Finally, the video will show you the basic API that enables you to add or delete rows, and also initialize field values when end-users add records using the Grid Control UI

Expanded New ItemRow

In the GridView, the new item row is an empty row that is used to enter new records. It can be displayed above or below all data and group rows. The new item row's position is specified by the GridView's GridOptionsView.NewItemRowPosition property. If this property is set to NewItemRowPosition.None, the new item row is hidden.

The new item row is identified by an asterisk (*) displayed within a corresponding row indicator cell. The images below show GridViews with the new item row located at the bottom and top of the view, respectively.

In Card Views and Layout Views, the new item card is displayed when a new card is added to the View (using the ColumnView.AddNewRow method or the embedded navigator). The card is displayed below all other cards.


When an end-user starts to edit the new item row/card, the ColumnView.InitNewRow event is raised. You can handle this event to initialize specific fields within the new record. For instance, you can handle this event to assign a unique value to the key field. End-users can cancel the addition of a new row by pressing the ESC key while it has focus. Once focus has been moved to another row, the newly added row is added to the data source and a blank new item row is displayed.

The following sample code handles the ColumnView.InitNewRow event to initialize new record fields with default values.

The image below illustrates the result. If an end-user initializes the Product field manually, the other fields are initialized automatically by the event handler.

Expanded See Also

How would you rate this topic?​​​​​​​