ValueDataMember Class

Provides the data for the series point values.

Namespace: DevExpress.XamarinForms.Charts

Assembly: DevExpress.XamarinForms.Charts.dll

Declaration

public class ValueDataMember :
    BindableObject

Remarks

To populate the ChartView series with data, you can bind it to a data source. To do this, set the Data property of your series to a SeriesDataAdapter instance and specify this adapter's properties: DataSource, ArgumentDataMember, and ValueDataMembers.

ValueDataMembers is a collection of data source fields that contain data values for series points. The number of individual ValueDataMember items in this collection depends on the series type: most series types (besides financial, range bar and bubble) require only one value to build each point of the series.

Use the ValueDataMember.Type and ValueDataMember.Member properties to specify the value type and data source field that contains data for series point values.

Examples

These examples show how to create and configure the data adapter to populate ChartView series of different types with data.

  • For most series types supported by ChartView (besides financial, range bar and bubble charts), specify one ValueDataMember object with the Type set to Value:

    <dxc:ChartView>
      <dxc:ChartView.Series>
        <dxc:LineSeries>
          <dxc:LineSeries.Data>
            <dxc:SeriesDataAdapter DataSource="{Binding GdpValues}" ArgumentDataMember="Year">
              <dxc:SeriesDataAdapter.ValueDataMembers>
                <dxc:ValueDataMember Type="Value" Member="Value"/>
              </dxc:SeriesDataAdapter.ValueDataMembers>
            </dxc:SeriesDataAdapter>
          </dxc:LineSeries.Data>
        </dxc:LineSeries>
      </dxc:ChartView.Series>
    </dxc:ChartView>
    
    NOTE

    ValueDataMembers is a content property. You can skip property tags in the markup.

  • For financial series (CandleStickSeries and StockSeries), specify four ValueDataMember objects with Type set to High, Low, Open, and Close:

    <dxc:ChartView>
      <dxc:ChartView.Series>
        <dxc:CandleStickSeries>
          <dxc:CandleStickSeries.Data>
            <dxc:SeriesDataAdapter DataSource="{Binding StockPrices}" ArgumentDataMember="Date">
                <dxc:ValueDataMember Type="High" Member="HighValue" />
                <dxc:ValueDataMember Type="Low" Member="LowValue" />
                <dxc:ValueDataMember Type="Open" Member="OpenValue" />
                <dxc:ValueDataMember Type="Close" Member="CloseValue" />
            </dxc:SeriesDataAdapter>
          </dxc:CandleStickSeries.Data>
        </dxc:CandleStickSeries>
      </dxc:ChartView.Series>
    </dxc:ChartView>
    
  • For RangeBarSeries, specify two ValueDataMember objects with Type set to High and Low:

    <dxc:ChartView>
        <dxc:ChartView.Series>
            <dxc:RangeBarSeries>
                <dxc:RangeBarSeries.Data>
                    <dxc:SeriesDataAdapter DataSource="{Binding OilPrices}" ArgumentDataMember="Month">
                        <dxc:ValueDataMember Type="High" Member="HighValue" />
                        <dxc:ValueDataMember Type="Low" Member="LowValue" />
                    </dxc:SeriesDataAdapter>
                </dxc:RangeBarSeries.Data>
            </dxc:RangeBarSeries>
        </dxc:ChartView.Series>
    </dxc:ChartView>
    
  • For BubbleSeries, specify two ValueDataMember objects with Type set to Value and Weight:

    <dxc:ChartView>
      <dxc:ChartView.Series>
        <dxc:BubbleSeries>
          <dxc:BubbleSeries.Data>
            <dxc:SeriesDataAdapter DataSource="{Binding HighestGrossingFilms}" ArgumentDataMember="Date">
                <dxc:ValueDataMember Type="Value" Member="Value" />
                <dxc:ValueDataMember Type="Weight" Member="WorldwideGrosses" />
            </dxc:SeriesDataAdapter>
          </dxc:BubbleSeries.Data>
        </dxc:BubbleSeries>
      </dxc:ChartView.Series>
    </dxc:ChartView>
    

Inheritance

Object
Xamarin.Forms.BindableObject
ValueDataMember
See Also