BuyLog In
Breaking Change T986360
Visible to All Users

Charts - The DxChartCommonSeries.AggregationMethod and DxChartSeries.AggregationMethod properties have become obsolete

What Changed

We marked the DxChartCommonSeries.AggregationMethod and DxChartSeries.AggregationMethod properties as obsolete. Now, you can use the DxChartCommonSeries.SummaryMethod and DxChartSeries.SummaryMethod properties instead.

Reasons for Change

The names of the new SummaryMethod properties better describe the properties' purpose. These properties specify a method that calculates summaries for chart points with the same argument values.

Meanwhile, in this release, we used the Aggregation term for a new chart feature - data aggregation. Now, you can specify an aggregation method to group series points with different argument values.

Impact on Existing Apps

This change affects applications if the AggregationMethod properties are specified.

Razor
<DxChart Data="@ChartsData">
    <DxChartCommonSeries NameField="@((SaleInfo s) => s.Date.Year)" 
                                             Filter="@((SaleInfo s) => s.Region == "Europe")" 
                                             AggregationMethod="Enumerable.Sum" 
                                             ArgumentField="@((SaleInfo s) => s.City)" 
                                             ValueField="@((SaleInfo s) => s.Amount)" 
                                             SeriesType="@(ChartSeriesType.Bar)" />
   @*...*@                    
    <DxChartAreaSeries Name="2017" 
                                     Filter="@((SaleInfo s) => s.Date.Year == 2017)"
                                     ArgumentField="@(s => s.City)" 
                                     ValueField="@(s => s.Amount)"
                                     AggregationMethod="Enumerable.Sum" />                 

</DxChart>

How to Update Existing Apps

Replace AggregationMethod with SummaryMethod.

Razor
<DxChart Data="@ChartsData">
    <DxChartCommonSeries NameField="@((SaleInfo s) => s.Date.Year)" 
                                             Filter="@((SaleInfo s) => s.Region == "Europe")" 
                                             SummaryMethod="Enumerable.Sum" 
                                             ArgumentField="@((SaleInfo s) => s.City)" 
                                             ValueField="@((SaleInfo s) => s.Amount)" 
                                             SeriesType="@(ChartSeriesType.Bar)" />
   @*...*@                     
    <DxChartAreaSeries Name="2017" 
                                     Filter="@((SaleInfo s) => s.Date.Year == 2017)"
                                     ArgumentField="@(s => s.City)" 
                                     ValueField="@(s => s.Amount)"
                                     SummaryMethod="Enumerable.Sum" />                 

</DxChart>

Disclaimer: The information provided on DevExpress.com and affiliated web properties (including the DevExpress Support Center) is provided "as is" without warranty of any kind. Developer Express Inc disclaims all warranties, either express or implied, including the warranties of merchantability and fitness for a particular purpose. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.

Confidential Information: Developer Express Inc does not wish to receive, will not act to procure, nor will it solicit, confidential or proprietary materials and information from you through the DevExpress Support Center or its web properties. Any and all materials or information divulged during chats, email communications, online discussions, Support Center tickets, or made available to Developer Express Inc in any manner will be deemed NOT to be confidential by Developer Express Inc. Please refer to the DevExpress.com Website Terms of Use for more information in this regard.