Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[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
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Collapse]Gauges
   [Expand]Getting Started
   [Collapse]Concepts
    [Expand]Gauge Types
    [Expand]Visual Elements
    [Expand]Appearance Customization
     Coordinate System
     Data Binding
     Saving and Restoring Gauge Layout and Style Settings
   [Expand]Design-Time Features
   [Expand]Examples
   [Expand]Product Information
  [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]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Data Binding

This document provides information on the data-binding mechanism in the XtraGauges Suite, and lists specific gauge elements that can be used in this process.

Expanded Data Binding Overview

Certain gauge elements are static, while others change their position, state or contents depending upon specific settings.

  • In circular gauges, a needle is typically used to point to the current value (ArcScale.Value). When the value changes, the needle automatically rotates.
  • In linear gauges, a level bar changes its position according to the scale's current value (LinearScale.Value).
  • Digital gauges are updated every time their text changes (DigitalGauge.Text).
  • State indicator gauges display corresponding images dependent upon the current state (StateIndicator.StateIndex).

All these properties can be changed manually in code or data-bound to data sources using the standard .NET data-binding mechanism. To bind these properties, use the DataBindings objects provided by gauge elements.

Data binding to one of these properties is available both at design time and runtime.

For example, the following image demonstrates data binding to the value of a circular gauge's scale via the property grid at design time.

Expanded Examples

To learn more about how to bind these properties to data sources, please refer to the following samples.

How would you rate this topic?​​​​​​​