WebChartControl.CalculatedFields Property

Returns a collection of calculated fields.

Namespace: DevExpress.XtraCharts.Web

Assembly: DevExpress.XtraCharts.v24.1.Web.dll

NuGet Package: DevExpress.Web.Visualization

Declaration

C#

public ChartCalculatedFieldCollection CalculatedFields { get; }

VB.NET

Public ReadOnly Property CalculatedFields As ChartCalculatedFieldCollection

Property Value

Type	Description
ChartCalculatedFieldCollection	A collection that stores calculated fields.

Remarks

Calculated fields allow you to evaluate values based on an expression and use them as a data source for series arguments, values, tooltips, crosshair labels, and so on.

To add a calculated field to a Chart Control, add a ChartCalculatedField object to the CalculatedFields collection and specify the following parameters:

• Expression - An expression is a string that, when parsed and processed, evaluates a value. Expressions can consist of column/field names in brackets, constants, operators, and functions. Refer to Criteria Language Syntax for information on expression syntax.

• FieldType - Specifies the type of resulting values. The ChartCalculatedFieldType enumeration lists supported types.

• Name (inherited from ChartElementNamed) - The calculated field’s unique name. Avoid dots in names because the Chart uses dots to access data source members. Use the name to specify series data members (for example, SeriesBase.ArgumentDataMember, SeriesBase.ValueDataMembers, SeriesBase.ToolTipHintDataMember, or SeriesBase.ColorDataMember). You can also use calculated field names to configure text patterns.

Optional parameters:

• DataSource - Allows you to specify a custom data source to evaluate the specified expression. The calculated field and series must use the same data source. Series can obtain data from the chart’s data source or can be bound to a separate data source (see the Series.DataSource property). If the calculated field’s DataSource property is not specified, the field uses the corresponding series’s data source.

• DataMember - Allows you to specify the name of the sub-list or table if the data source contains more than one distinct list of data items.

• DisplayName - The calculated field’s display name that appears in the Chart Designer‘s Chart Data tab. If DisplayName is not specified, the Name property value is used instead.

Example

The following example shows how to create a calculated field and then use this field as a data source for a series. The field’s values are calculated by the following expression: [Time.Seconds] * [Velocity].

ASPX

<dx:WebChartControl ID="WebChartControl1" runat="server" CrosshairEnabled="True" Height="360px" Width="640px">
    ...
    <CalculatedFields>
        <dx:ChartCalculatedField DisplayName="Displacement (m)" 
                                  Expression="[Time.Seconds]*[Velocity]" 
                                  FieldType="Double" 
                                  Name ="Displacement/>
    </CalculatedFields>
    <SeriesSerializable>
        <dx:Series Name="Series 1" 
                   ArgumentDataMember="Time" 
                   ValueDataMembersSerializable="Displacement">                        
            <viewserializable>
                <dx:SplineSeriesView>
                </dx:SplineSeriesView>
            </viewserializable>
        </dx:Series>
    </SeriesSerializable>
</dx:WebChartControl>

C#

using System;
using System.Collections.Generic;

namespace ChartCalculatedFields {
    public partial class WebForm1 : System.Web.UI.Page {
        protected void Page_Load(object sender, EventArgs e) {
            WebChartControl1.DataSource = GetDataPoints();
            WebChartControl1.DataBind();
        }
        public List<DataPoint> GetDataPoints() {
            List<DataPoint> dataPoints = new List<DataPoint>() {
                new DataPoint (new TimeSpan(0, 0, 0), 10),
                new DataPoint (new TimeSpan(0, 0, 1), 11.46),
                new DataPoint (new TimeSpan(0, 0, 2), 11.90),
                new DataPoint (new TimeSpan(0, 0, 3), 12.1),
                new DataPoint (new TimeSpan(0, 0, 4), 12.236),
                new DataPoint (new TimeSpan(0, 0, 5), 12.325),
                new DataPoint (new TimeSpan(0, 0, 6), 12.625),
                new DataPoint (new TimeSpan(0, 0, 7), 13.896),
                new DataPoint (new TimeSpan(0, 0, 8), 14.123),
                new DataPoint (new TimeSpan(0, 0, 9), 14.623),
                new DataPoint (new TimeSpan(0, 0, 10), 15.007),
                new DataPoint (new TimeSpan(0, 0, 11), 15.452),
                new DataPoint (new TimeSpan(0, 0, 12), 15.756)
            };
            return dataPoints;
        }
    }
    public class DataPoint {
        public TimeSpan Time { get; set; }
        public double Velocity { get; set; }
        public DataPoint(TimeSpan time, double velocity) {
            this.Time = time;
            this.Velocity = velocity;
        }
    }
}

VB.NET

Imports System
Imports System.Collections.Generic

Namespace ChartCalculatedFields
    Public Partial Class WebForm1
        Inherits Web.UI.Page

        Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
            WebChartControl1.DataSource = GetDataPoints()
            WebChartControl1.DataBind()
        End Sub

        Public Function GetDataPoints() As List(Of DataPoint)
            Dim dataPoints As List(Of DataPoint) = New List(Of DataPoint)() From {
                New DataPoint(New TimeSpan(0, 0, 0), 10),
                New DataPoint(New TimeSpan(0, 0, 1), 11.46),
                New DataPoint(New TimeSpan(0, 0, 2), 11.90),
                New DataPoint(New TimeSpan(0, 0, 3), 12.1),
                New DataPoint(New TimeSpan(0, 0, 4), 12.236),
                New DataPoint(New TimeSpan(0, 0, 5), 12.325),
                New DataPoint(New TimeSpan(0, 0, 6), 12.625),
                New DataPoint(New TimeSpan(0, 0, 7), 13.896),
                New DataPoint(New TimeSpan(0, 0, 8), 14.123),
                New DataPoint(New TimeSpan(0, 0, 9), 14.623),
                New DataPoint(New TimeSpan(0, 0, 10), 15.007),
                New DataPoint(New TimeSpan(0, 0, 11), 15.452),
                New DataPoint(New TimeSpan(0, 0, 12), 15.756)
            }
            Return dataPoints
        End Function
    End Class

    Public Class DataPoint
        Public Property Time As TimeSpan
        Public Property Velocity As Double

        Public Sub New(ByVal time As TimeSpan, ByVal velocity As Double)
            Me.Time = time
            Me.Velocity = velocity
        End Sub
    End Class
End Namespace