[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Collapse]Vertical Grid
   [Collapse]Binding to Data
     Unbound Mode
     Unbound Rows
   [Expand]Data Layout: Records, Rows and Cells
   [Expand]Layouts
   [Expand]Data Editing and Validation
    Filtering
    Formatting Values
   [Expand]Drag and Drop
   [Expand]Appearance and Custom Painting
   [Expand]Visual Elements
   [Expand]Design-Time Features
   [Expand]End-User Capabilities
    Hit Information
    Batch Modifications
   [Expand]Member Tables
   [Expand]Examples
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Reporting
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Unbound Mode

This topic describes how to use the Vertical Grid Control (VGridControl) when it isn't bound to any data source (unbound mode). For a list of all the data modes supported by the vertical grid controls, see the Data Modes Overview topic.

 

Expanded Unbound Mode Overview

A vertical grid control functions in Unbound Mode if it isn't bound to any data source, this means that the VGridControl.DataSource property's value is null.

Unbound mode is appropriate for displaying lists of label-value pairs which can be optionally categorized, as in the image below:

For instance, you can use unbound mode if you need to edit a number of option values, which may have different data types. If you need to display and edit properties of a specific object you can also consider using the PropertyGridControl.

Like in bound mode, in unbound mode you can assign editors to cells to provide a handy way to edit cell values. Any editor from the DevExpress Editors Library can be used. In addition you can organize rows into categories and create hierarchy structures.

Generally, implementing unbound mode involves the following steps:

  • create the required rows and arrange them in a specific manner;
  • associate editors with the created rows (row items);
  • use the row's RowProperties.Value property to set initial cell values.

Expanded An Example of Using Unbound Mode

This example will create two editor rows in a VGridControl which are united into a single category. The first row ('Output Path') will use the text editor to edit its value. Another row ('Generate Debugging Information') will use the check box.

Follow the steps below:

  1. Run the control's Designer. To do this, right-click on the control and choose the Run Designer item from its context menu.

  2. Ensure that the Rows Page is open. Use the down arrow button to invoke the dropdown window which lists the row types. Choose the CategoryRow item. This will add a category row to the vertical grid. Add two editor rows in a similar manner. Drag the editor rows to the category row to include them in that category.

  3. Select the category row. Set its RowProperties.Caption property to 'Outputs'. The image below demonstrates how to do this. In the same way specify the 'Output Path' and 'Generate Debugging Information' captions to the editor rows.

  4. Select the 'Generate Debugging Information' row and bind a check box editor to it. The image below demonstrates how to do this.

  5. Specify a value for the 'Generate Debugging Information' row's value. This can be done using the Object Editor dialog which is invoked by clicking on the button which corresponds to the RowProperties.Value property.

  6. Set the 'Output Path' row's RowProperties.Value property to the 'Outputs\Debug' string.

  7. Close the VerticalGrid Designer and run the application. The image below shows the result.

Is this topic helpful?​​​​​​​