[Expand]General Information
[Expand]WinForms Controls
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Collapse]WPF Controls
  Prerequisites
 [Expand]What's Installed
 [Expand].NET Core 3 Support
 [Expand]Common Concepts
 [Expand]MVVM Framework
 [Collapse]Controls and Libraries
   Reporting
  [Expand]Data Grid
  [Expand]Ribbon, Bars and Menu
  [Collapse]Charts Suite
   [Collapse]Chart Control
    [Expand]Getting Started
    [Expand]Fundamentals
    [Collapse]Providing Data
      Create a Series Manually
      Add Points to a Series Manually
      Bind a Series to a Data Source
      Define a Template for Automatic Series
      Provide Data for the Drill Mode
      Best Practices: Display Large Data
      Series Scale Types
      Data Aggregation
      Calculate Summaries
      Data Filtering
      Colorizers
      Work Time and Workday Configuration
      Top N and Others
      Histogram
      Empty Points
    [Expand]Chart Elements
    [Expand]Appearance Customization
    [Expand]End-User Features
    [Expand]Design-Time Features
    [Expand]Examples
    [Expand]Additional Resources
   [Expand]Chart3D Control
  [Expand]Pivot Grid
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Expand]Rich Text Editor
  [Expand]Tree List
  [Expand]Gauge Controls
  [Expand]Map Control
  [Expand]Layout Management
  [Expand]Windows Modern UI
  [Expand]Printing-Exporting
  [Expand]Data Editors
  [Expand]Navigation Controls
  [Expand]Spell Checker
  [Expand]Property Grid
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Gantt Control
  [Expand]Diagram Control
  [Expand]Windows and Utility Controls
   Dialogs, Notifications and Panels
  [Expand]Scheduler (legacy)
 [Expand]Scaffolding Wizard
 [Expand]Localization
  Redistribution and Deployment
  Get More Help
 [Expand]API Reference
[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)

Empty Points

This topic explains what Empty Points are, how the Chart Control processes empty points, and how to add such a point to a chart.

Empty points are points with undefined values (see SeriesPoint.Value). You can use empty points to insert gaps between series point values. The Chart displays empty points as breaks in continuous series (for example, Line or Area), and missing points or bars in discrete series (for example, Bars or Points). Empty points in the Pie, Donut, and Funnel series are skipped.

The following table contains data for the charts above:

Date Politics Entertainment Travel
01-Jan-19 65 56 45
02-Jan-19 78 45 40
03-Jan-19 95 70 56
04-Jan-19 110 82 47
05-Jan-19 108 80 38
06-Jan-19 52 20 31
07-Jan-19 46 10 27
08-Jan-19 70 27
09-Jan-19 86 42
10-Jan-19 92 65
11-Jan-19 108 45 37
12-Jan-19 115 56 21
13-Jan-19 75 10 10
14-Jan-19 65 0 5
Note

19.2 Demo Center: Launch the Empty Points demo

To make a point empty, do one of the following:

  • set a point's value to NaN if you use the Chart Designer to add points to a series.

  • leave a value undefined if you add points in markup.

  • use the SeriesPoint (see SeriesPoint)'s class DevExpress.Xpf.Charts.SeriesPoint.%23ctor* that take only an argument as a parameter if you add points to a series in code.

  • or set a data point's numeric value to System.Double.NaN(or System.Single.NaN) in a data source. If a series point has a date-time value, use the System.DateTime.MinValue value. Use System.TimeSpan.Zero for the time-span series point values.

    Markup:

    Code-Behind:

Missing points (points that do not exist for particular axis arguments) are represented as empty points if the ProcessMissingPoints (NumericAggregationScaleOptionsBase.ProcessMissingPoints, DateTimeAggregationScaleOptionsBase.ProcessMissingPoints or TimeSpanAggregationScaleOptionsBase.ProcessMissingPoints) property is set to InsertEmptyPoints.

Tip

Expanded Show Isolated Points

The Chart does not draw a point between two empty points. To display a point in this case, enable the ShowIsolatedPoints (LineSeries2D.ShowIsolatedPoints or CircularLineSeries2D.ShowIsolatedPoints) property.

ShowIsolatedPoints = true ShowIsolatedPoints = false

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