SeriesBase.SeriesPointsSorting Property

Gets or sets the sort order of the series’ points.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v19.2.dll

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
public SortingMode SeriesPointsSorting { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
Public Property SeriesPointsSorting As SortingMode

Property Value

Type	Description
SortingMode	A SortingMode enumeration value.

Available values:

Name	Description
None	The values are not sorted.
Ascending	The values are sorted in ascending order.
Descending	The values are sorted in descending order.

Remarks

Series points can be sorted based on either their arguments or data values, specified by the SeriesBase.SeriesPointsSortingKey property. Use the SeriesPointsSorting property to choose a mode for sorting data points within the series.

When there are multiple series available in a chart’s collection, and point sorting is applied to either of these series, points are sorted within all existing series.

The following images demonstrate the three modes available for the SeriesPointsSorting property, with the series points sorted by their values.

SeriesPointsSorting = None	SeriesPointsSorting = Ascending SeriesPointsSortingKey = Value_1	SeriesPointsSorting = Descending SeriesPointsSortingKey = Value_1

For more information, refer to Sorting Data.

Example

The following properties allow you to sort series points within a series.

Property	Description
SeriesBase.SeriesPointsSortingKey	Specifies the point sort order.
SeriesBase.SeriesPointsSorting	Specifies the value by which series points should be sorted.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-sort-series-points-within-a-series-t448690

Form1.cs

using DevExpress.XtraCharts;
using System;
using System.Windows.Forms;

namespace SeriesPointsSorting {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        #region #SeriesPointSorting
        private void Form1_Load(object sender, EventArgs e) {
            this.gSPTableAdapter.Fill(this.gspDataSet.GSP);

            SeriesBase seriesTemplate = chart.SeriesTemplate;
            seriesTemplate.SeriesPointsSorting = SortingMode.Ascending;
            seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1;
        }
        #endregion #SeriesPointSorting
    }
}

Form1.vb

Imports DevExpress.XtraCharts
Imports System
Imports System.Windows.Forms

Namespace SeriesPointsSorting
    Partial Public Class Form1
        Inherits Form

        Public Sub New()
            InitializeComponent()
        End Sub

        #Region "#SeriesPointSorting"
        Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles MyBase.Load
            Me.gSPTableAdapter.Fill(Me.gspDataSet.GSP)

            Dim seriesTemplate As SeriesBase = chart.SeriesTemplate
            seriesTemplate.SeriesPointsSorting = SortingMode.Ascending
            seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1
        End Sub
        #End Region ' #SeriesPointSorting
    End Class
End Namespace

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the SeriesPointsSorting property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-draw-a-custom-legend-marker-for-a-series-point-t332652/CS/CustomSeriesPointDrawingSample/Form1.cs#L53

    chart.SeriesTemplate.ToolTipPointPattern = "{S}: {A} ({VP:P})";
    chart.SeriesTemplate.SeriesPointsSorting = SortingMode.Ascending;
}

how-to-sort-series-points-within-a-series-t448690/CS/SeriesPointsSorting/Form1.cs#L16

SeriesBase seriesTemplate = chart.SeriesTemplate;
seriesTemplate.SeriesPointsSorting = SortingMode.Ascending;
seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1;

VB.NET

how-to-draw-a-custom-legend-marker-for-a-series-point-t332652/VB/CustomSeriesPointDrawingSample/Form1.vb#L51

    chart.SeriesTemplate.ToolTipPointPattern = "{S}: {A} ({VP:P})"
    chart.SeriesTemplate.SeriesPointsSorting = SortingMode.Ascending
End Sub

how-to-sort-series-points-within-a-series-t448690/VB/SeriesPointsSorting/Form1.vb#L18

Dim seriesTemplate As SeriesBase = chart.SeriesTemplate
seriesTemplate.SeriesPointsSorting = SortingMode.Ascending
seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1