Editing Behavior Overview (WebHierarchicalDataGrid)

WebHierarchicalDataGrid™ is read-only by default. You must enable the EditingCore behavior to allow interaction with the control. After EditingCore is enabled you can edit WebHierarchicalDataGrid in code; however, if you want to allow your end-users to edit, delete, and add data using WebHierarchicalDataGrid’s UI, you must enable additional behaviors. These are all considered dependent behaviors specific to the user interaction. Once editing is enabled, data updates commit immediately to the data source.


Set the DataKeyFields property to the name of the primary key column in your data source to ensure that changes in WebHierarchicalDataGrid can be updated in data source.

Dependent Behaviors

  • Cell Editing - Allows data manipulation in the cells of WebHierarchicalDataGrid. End-users are allowed to edit data when this behavior is enabled.

  • Row Editing - An editing experience that places the entire row in edit mode. Changes are saved are rejected using Done and Cancel buttons respectively.

  • Row Adding - Enabling this behavior creates an interface in which users can add new rows to WebHierarchicalDataGrid: A blank row is placed at the bottom or top of the control.

  • Row Deleting - Allows data deletion. To delete, end-users can select the row(s) and hit the Delete key.

  • Row Editing Template - Allows data manipulation of a row through a template that you create.


These behaviors are all dependent on the EditCore behavior; when you remove the EditCore behavior, these behaviors will also get removed.

For more information on editing in WebHierarchicalDataGrid, click the links below.