SeriesBase.SeriesPointsSortingKey Property

Gets or sets a value that specifies the values of the data points that the series should be sorted by.

Namespace: DevExpress.XtraCharts

Assembly: DevExpress.XtraCharts.v18.2.dll

Declaration

C#

[XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)]
[XtraSerializableProperty]
public SeriesPointKey SeriesPointsSortingKey { get; set; }

VB.NET

<XtraChartsLocalizableCategory(XtraChartsCategory.Behavior)>
<XtraSerializableProperty>
Public Property SeriesPointsSortingKey As SeriesPointKey

Property Value

Type	Description
SeriesPointKey	A SeriesPointKey enumeration value.

Available values:

Name	Description
Argument	Specifies that sorting is performed by the argument values of a series’ data points.
Value_1	Specifies that sorting is performed by the first data value within the SeriesPoint.Values array of a series’s data points. For financial data this indicates the Low value.
Value_2	Specifies that sorting is performed by the second data value within the SeriesPoint.Values array of a series’s data points. For financial data this indicates the High value.
Value_3	Specifies that sorting is performed by the third data value within the SeriesPoint.Values array of a series’s data points. For financial data this indicates the Open value.
Value_4	Specifies that sorting is performed by the fourth data value within the SeriesPoint.Values array of a series’s data points. For financial data this indicates the Close value.

Remarks

Series points can be sorted based upon either their arguments or data values. Use the SeriesPointsSortingKey property to specify which values of the series’ data points should be used to sort the series data.

The sort order can be specified via the SeriesBase.SeriesPointsSorting property.

Note

Since, for some series view types, multiple values for each data point are required, there are four value modes for the SeriesBase.SeriesPointsSortingKey property. So, at runtime, to sort by values points of a series whose view type supports only a single value, choose the SeriesPointKey.Value_1 setting.

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 snippet (auto-collected from DevExpress Examples) contains a reference to the SeriesPointsSortingKey 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-sort-series-points-within-a-series-t448690/CS/SeriesPointsSorting/Form1.cs#L17

    seriesTemplate.SeriesPointsSorting = SortingMode.Ascending;
    seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1;
}

VB.NET

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

    seriesTemplate.SeriesPointsSorting = SortingMode.Ascending
    seriesTemplate.SeriesPointsSortingKey = SeriesPointKey.Value_1
End Sub