A string specifing an edit value that can be bound to an edit form's editor.
This documentation topic describes legacy technology. We no longer develop new functionality for the GridControl and suggest that you use the new DataGridView control instead.
When you create a custom row edit form, bind this form's editors to edit values contained in the EditValuesContainer.Values dictionary. A column containing a cell to which a value entered in the form's editor should be assigned is identified by the column's field name (GridColumn.FieldName). For example, an editor bound to Values[Name] shows or sets a cell value of the grid's Name column. However, if a column's field name is complex (a field name is constructed in the "String1.String2" form), you need to use the GetBindingPath method when binding a form's editor to a grid's edit value. This method masks a dot in a complex field name. For example, GetBindingPath("Product.Name") returns "Values[Product##DoT##Name]".
GridControl allows you to substitute the default row edit form with a custom form. This example explains how to do this.
Number of ordered product units (the Quantity column)
Order total value (the Total column)
A value indicating whether an order is shipped (the Shipped column)
The default row edit form in this grid looks like the following.
This example demonstrates how to create a custom form to add new data rows and another form to edit existing rows.
Add New Order Form
This form is invoked on tapping New Item Row in the grid and allows an end user to add a new data row (create a new order). On this form, an end user can select a product name via a Picker control, and set the number of ordered product units via a Slider control. A unit price is automatically shown for the selected product, and the order total value is automatically calculated.
Edit Order Form
This form is invoked on double-tapping a cell or selecting Edit Cell from the popup menu. It allows an end user to modify existing data rows. On this form, product name and unit price are shown in Lable controls and cannot be changed. An end user can change the number of ordered product units via a Slider control and use the Switch control to set whether the order is shipped.
To create a custom row edit form and show it instead of the default form, execute the steps below.
Specify a custom form view. In this example, it is a ContentView descendant with a set of labels and editors inside (see the CustomFormEditorContent.cs file). This view's BindingContext is an EditValuesContainer object.
Labels and editors are bound to data fields via the EditValuesContainer.GetBindingPath method with data field names passed as parameters.
We are updating the DevExpress product documentation website and this page is part of our new experience. During this transition period, product documentation remains available in our previous format at documentation.devexpress.com. Learn More...
Was this page helpful?
Thanks for your feedback! Any other suggestions? Tell us here.