Data Rows
- 2 minutes to read
Rows are used to display and edit data. ASPxVerticalGrid supports both bound and unbound rows.
- Bound rows represent fields in the ASPxVerticalGrid‘s data source. Their VerticalGridDataRow.FieldName properties refer to valid fields in a data source.
- Unbound rows are not bound to any field in a data source. These rows must be populated manually. For information, see Unbound Rows.
There are fifteen types of server data rows.
| Class Name | Description |
|---|---|
| VerticalGridBinaryImageRow | A row used to display images from a binary stream. |
| VerticalGridButtonEditRow | A row with the button editor. |
| VerticalGridCheckRow | A row used to display and edit data from a Boolean data field. |
| VerticalGridColorEditRow | A row used to display and edit color values. |
| VerticalGridComboBoxRow | A row whose values are edited using the combo box editor. |
| VerticalGridDateRow | A row used to display and edit data from a DateTime data field. |
| VerticalGridDropDownEditRow | A row with an editor containing a customizable dropdown window. |
| VerticalGridHyperLinkRow | A row with a hyperlink functionality. |
| VerticalGridImageRow | A row used to display images from specified URLs. |
| VerticalGridMemoRow | A row used to display and edit memo data. |
| VerticalGridProgressBarRow | A row with the Progress Bar editor. |
| VerticalGridSpinEditRow | A row used to display and edit numeric data. |
| VerticalGridTextRow | A row used to display and edit text. |
| VerticalGridTimeEditRow | A row used to display and edit time portions of DateTime values. |
| VerticalGridTokenBoxRow | A row with the token box editor. |
On the client, rows are represented by ASPxClientVerticalGridRow objects.
Behavior
Since different types of rows present different types of data, they provide their own editors. For example, Boolean values are edited using a check box editor, while DateTime values are edited using a DateTime editor. To access and customize the row editor’s settings, use the VerticalGridEditDataRow.PropertiesEdit property.
Rows provide a set of Boolean properties that enable you to specify which elements of a row’s functionality (sorting, filtering, etc.) are available to end-users. These options can be accessed using the ASPxVerticalGrid.Settings property.
To make a row read-only, set its VerticalGridDataRow.ReadOnly property to true.
Visibility
The row’s visibility is specified by its WebColumnBase.Visible property. Its position among other visible rows is specified by its WebColumnBase.VisibleIndex property.