Skip to main content

SeriesDataAdapter.ValueDataMembers Property

Gets a collection of the names of data source fields that contain series point values. This is a bindable property.

Namespace: DevExpress.Maui.Charts

Assembly: DevExpress.Maui.Charts.dll

NuGet Package: DevExpress.Maui.Charts

Declaration

public ValueDataMemberCollection ValueDataMembers { get; }

Property Value

Type Description
ValueDataMemberCollection

The collection of the names of data fields that contain series point values.

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 — the data source for the chart.
  • ArgumentDataMember — the data source field that contains argument values. Each data point of a series requires one argument value.
  • ValueDataMembers — the collection of data source fields that contain data values for series points. The number of items in the collection depends upon the series type (see the Examples section below).

    An individual item in this collection is a ValueDataMember object. Use its Type and Member properties to specify the value type and data source field that contains data for series point values.

Example

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>
    
See Also