Dundas Chart for Windows Forms
Sort(PointsSortOrder,String,String) Method
See Also  Example Send comments on this topic.
DundasWinChart Assembly > Dundas.Charting.WinControl Namespace > DataManipulator Class > Sort Method : Sort(PointsSortOrder,String,String) Method


order
A PointsSortOrder enumeration value that determines if the sort is ascending or descending.
Sorting order.
sortBy

A string value that represents the data point values to be sorted. Possible values are: "X", "Y", "Y2", "Y3", "AxisLabel", etc. 

Note:  If X-values are of type string, they are stored in the AxisLabel,  this should be specified instead of "X".


Value to sort by.
seriesName
The name(s) of the series to sort. For multiple series use a comma-separated list.
Comma separated sereies names to sort.

Performs a sort on one or more series' data points using the specified order. The sort can be based on any available data point value.


Sort series data points in specified order.

Syntax

Visual Basic (Declaration)  
Public Overloads Sub Sort( _
   ByVal order As PointsSortOrder, _
   ByVal sortBy As String, _
   ByVal seriesName As String _
) 
Visual Basic (Usage) Copy Code
Dim instance As DataManipulator
Dim order As PointsSortOrder
Dim sortBy As String
Dim seriesName As String
 
instance.Sort(order, sortBy, seriesName)
C#  
public void Sort( 
   PointsSortOrder order,
   string sortBy,
   string seriesName
)

Parameters

order
A PointsSortOrder enumeration value that determines if the sort is ascending or descending.
Sorting order.
sortBy

A string value that represents the data point values to be sorted. Possible values are: "X", "Y", "Y2", "Y3", "AxisLabel", etc. 

Note:  If X-values are of type string, they are stored in the AxisLabel,  this should be specified instead of "X".


Value to sort by.
seriesName
The name(s) of the series to sort. For multiple series use a comma-separated list.
Comma separated sereies names to sort.

Example

Perform an ascending sort two series named "Series1" and "Series2" before data is displayed by the chart. We will assume 2 bubble chart charts are being displayed, and will sort the data based on their second Y-value ("Y2", the radius of each bubble).
Visual Basic Copy Code
Imports Dundas.Charting.WinControl
...

Private Sub Page_Load(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles MyBase.Load
    Chart1.DataManipulator.Sort(PointsSortOrder.Ascending, "Y2", "Series1,Series2")
End Sub

Remarks

This method performs an ascending or descending sort on a series' data points, and is based on the value that is set by the sortBy parameter (e.g. "X", "AxisLabel", "Y", "Y1", etc.) .

Note that if multiple series are sorted then the series must be aligned, otherwise an exception will be thrown. Refer to the Aligning Series topic for information on aligned series.

IMPORTANT: ALL series will be sorted using the specified Y-value from the FIRST listed series (i.e. all data points, regardless of the series they belong to, are sorted based on the first series).

To sort points using a custom sort routine use another definition of this overloaded method.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2009 All Rights Reserved.