TableView.ShowUpdateRowButtons Property

Gets or sets a mode that specifies how to show the buttons which allow you to update rows.

Namespace: DevExpress.Xpf.Grid

Assembly: DevExpress.Xpf.Grid.v21.2.dll

NuGet Package: DevExpress.Wpf.Grid.Core

Declaration

C#

public ShowUpdateRowButtons ShowUpdateRowButtons { get; set; }

VB.NET

Public Property ShowUpdateRowButtons As ShowUpdateRowButtons

Property Value

Type	Description
ShowUpdateRowButtons	A mode that specifies how to show the buttons which allow you to update rows.

Available values:

Name	Description
Never	The buttons are not shown.
OnCellEditorOpen	The buttons are shown after you open a cell editor.
OnCellValueChange	The buttons are shown after you change a cell value.

Remarks

The GridControl provides an edit mode that allows you to edit an entire row and only then post changes to the datasource. In this mode, the GridControl shows the Update and Cancel buttons for the row that is being edited. You should change the row’s cell values and then click Update to post chages:

You cannot navigate away from an edited row unless you click the Update / Cancel button or press Esc twice.

Run Demo: Edit Entire Row

To enable the Edit Entire Row mode, specify the ShowUpdateRowButtons property:

• When the property value is OnCellEditorOpen, the buttons are shown after you open a cell editor:

  

• When the property value is OnCellValueChange, the buttons are shown after you change a cell value:

  

Click the Update button to post the edited row’s changes to the datasource. Alternatively, you can call the TableView.UpdateRow / TreeListView.UpdateRow method or the TableViewCommands.UpdateRow / TreeListViewCommands.UpdateRow command.

Click the Cancel button to discard the edited row’s changes. Alternatively, you can call the TableView.CancelRowChanges / TreeListView.CancelRowChanges method or the TableViewCommands.CancelRowChanges / TreeListViewCommands.CancelRowChanges command.

Use the TableView.UpdateRowButtonsTemplate / TreeListView.UpdateRowButtonsTemplate property to change the appearance of the Update and Cancel buttons.

Limitations

• The Edit Entire Row mode is available in optimized mode only.
• The Edit Entire Row mode is incompatible with the Edit Form.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the ShowUpdateRowButtons property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

XAML

wpf-data-grid-implement-crud-operations/CS/CodeBehind/EFCore/PagedAsyncSource/MainWindow.xaml#L22

<dxg:GridControl.View>
    <dxg:TableView ShowUpdateRowButtons="OnCellEditorOpen" ValidateRow="OnValidateRow"
                   ShowFixedTotalSummary="True" DataSourceRefresh="OnDataSourceRefresh" />

wpf-data-grid-extend-crud-operations/CS/Undo/MainWindow.xaml#L24

<dxg:TableView NewItemRowPosition="Top"
               ShowUpdateRowButtons="OnCellEditorOpen"
               ValidateRowCommand="{Binding ValidateRowCommand}"

wpf-data-grid-bind-to-infiniteasyncsource/CS/InfiniteAsyncSourceSample/MainWindow.xaml#L41

NewItemRowPosition="Top"
ShowUpdateRowButtons="OnCellEditorOpen"
ValidateRow="CreateUpdateRow"

wpf-data-grid-getting-started-net-framework/CS/WPFDataGridGettingStartedNETFramework/MainWindow.xaml#L44

ShowFixedTotalSummary="True"
ShowUpdateRowButtons="OnCellEditorOpen"
ValidateRowCommand="{Binding ValidateAndSaveCommand}">