.NET MAUI DataGrid Editing
The DataGrid provides a built-in editing functionality, which allows the app users to easily edit the data presented in the Grid. Depending on the column data type, a relevant editor allows end users to edit content in a friendly environment. As soon as the user double-clicks on a certain cell, the cell is switched to an edit mode.
Important Properties
You need to define the UserEditMode
property of the DataGrid control to enable the editing feature.
The UserEditMode
property is of type Telerik.Maui.Controls.Compatibility.DataGrid.DataGridUserEditMode
and accepts the following values:
- (Default)
None
—Editing is disabled. -
Cell
—Enables the editing option.
In addition, you can independently disable editing for specific columns through the CanUserEdit
property of the DataGridColumn
class. For more details, refer to the Columns Overview topic.
Column Editors
Each DataGrid column type provides different editor, so that the content can be edited in a convenient manner according to its value type.
The following table lists the related .NET MAUI control for editing the values inside the DataGrid columns:
Column Type | Editor |
---|---|
TextColumn |
Entry |
NumericalColumn |
RadNumericInput |
BooleanColumn |
CheckBox |
DateColumn |
RadDatePicker |
TimeColumn |
RadTimePicker |
PickerColumn |
RadComboBox |
TemplateColumn |
A custom editor by defining CellEditTemplate . |
CellEditTemplate
If the default editors do not suit the scenario you have, create a custom editor for each column by utilizing the CellEditTemplate
property of the DataGridColumn
. For detailed information on how the CellEditTemplate
can be applied, refer to the Columns Cell Templates article.
Editing Commands
The DataGrid provides a few useful commands related to the editing functionality, such as:
-
BeginEdit
—Provides an entry point just before the editing begins. -
CancelEdit
—Provides an entry point just before the editing is canceled. -
CommitEdit
—Provides an entry point just before the editing is committed.
For detailed information on how to utilize any of the listed commands, go to the Editing Commands topic.
Styling
You can change the visual appearance of each editor through the CellEditorStyle
property of the DataGridColumn
. To the CellEditorStyle
you will need to apply a Xamarin.Forms.Style
with a TargetType
set to the corresponding to each column editor control.
The following snippet shows a CellEditorStyle
applied to the DataGridTextColumn
:
<telerik:DataGridTextColumn.CellEditorStyle>
<Style TargetType="Entry">
<Setter Property="FontSize" Value="Large"/>
<Setter Property="FontAttributes" Value="Bold"/>
</Style>
</telerik:DataGridTextColumn.CellEditorStyle>