Series.DisplayName Property

Gets or sets the display name of the series.

Namespace: DevExpress.Xpf.Charts

Assembly: DevExpress.Xpf.Charts.v19.2.dll

Declaration

C#

public string DisplayName { get; set; }

VB.NET

Public Property DisplayName As String

Property Value

Type	Description
String	A String representing the display name of the series.

Remarks

This name is used, for example, in a chart legend, to identify individual series.

Example

The following example demonstrates how to create a 2D Side-by-Side Bar. To do this, it is necessary to assign the ChartControl.Diagram property to XYDiagram2D, and then add two series with points to the diagram’s Diagram.Series collection.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/how-to-create-a-2d-side-by-side-bar-chart-e1257.

Window1.xaml

<Window x:Class="SideBySideBar2DChart.Window1" 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
        xmlns:dxc="http://schemas.devexpress.com/winfx/2008/xaml/charts" 
        Title="Window1" Height="350" Width="620">
    <Grid>
        <dxc:ChartControl Name="chartControl1">
            <dxc:ChartControl.Diagram>
                <dxc:XYDiagram2D>
                    <dxc:XYDiagram2D.Series>
                        <dxc:BarSideBySideSeries2D DisplayName="First Series" BarWidth="0.5">
                            <!--region #Model-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="1" />
                                <dxc:SeriesPoint Argument="B" Value="2" />
                                <dxc:SeriesPoint Argument="C" Value="3" />
                                <dxc:SeriesPoint Argument="D" Value="4" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                        <dxc:BarSideBySideSeries2D DisplayName="Second Series" BarWidth="0.5">
                            <!--region #Model2-->
                            <dxc:BarSideBySideSeries2D.Model>
                                <dxc:Quasi3DBar2DModel />
                            </dxc:BarSideBySideSeries2D.Model>
                            <!--endregion #Model2-->
                            <dxc:BarSideBySideSeries2D.Points>
                                <dxc:SeriesPoint Argument="A" Value="4" />
                                <dxc:SeriesPoint Argument="B" Value="3" />
                                <dxc:SeriesPoint Argument="C" Value="2" />
                                <dxc:SeriesPoint Argument="D" Value="1" />
                            </dxc:BarSideBySideSeries2D.Points>
                        </dxc:BarSideBySideSeries2D>
                    </dxc:XYDiagram2D.Series>
                </dxc:XYDiagram2D>
            </dxc:ChartControl.Diagram>
            <dxc:ChartControl.Legend>
                <dxc:Legend />
            </dxc:ChartControl.Legend>
        </dxc:ChartControl>
    </Grid>
</Window>

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DisplayName property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-display-check-boxes-for-legend-items-to-control-the-visibility-of-series-in-the-unbou-e2842/CS/MainWindow.xaml.cs#L26

newSeries.Points.Add(new SeriesPoint(1.0, 1.0));
newSeries.DisplayName = "Series" + seriesCount;
chart.Diagram.Series.Add(newSeries);

how-to-invoke-the-chart-designer-at-runtime-t254238/CS/ChartDesignerRuntime/MainWindow.xaml#L93

<dxc:LineSeries2D
    DisplayName="Temperature (F)"
    DataSource="{Binding Mode=OneWay, Source={StaticResource weatherData}, XPath=Weather}"

how-to-invoke-the-chart-designer-at-runtime-t463702/CS/WpfApplication1/MainWindow.xaml#L19

</dxc:XYDiagram2D.Panes>
<dxc:BarSideBySideSeries2D DisplayName="Series 1">
    <dxc:SeriesPoint Argument="A" Value="5"/>

how-to-show-the-crosshair-cursor-programmatically-t466164/CS/ShowCrosshairExample/MainWindow.xaml#L75

<dxc:XYDiagram2D.Series>
    <dxc:LineSeries2D DisplayName="Temperature"
                      ShowInLegend="False">

wpf-charts-show-a-context-menu-for-chart-elements/CS/WpfApplication14/MainWindow.xaml#L20

<dxc:XYDiagram2D>
    <dxc:BarSideBySideSeries2D DisplayName="Bar Series">
        <dxc:SeriesPoint Argument="A" Value="3" />

VB.NET

wpf-dashboard-how-to-obtain-clicked-item-data/VB/Dashboard_ClientDataCards_Wpf/MainWindow.xaml.vb#L62

Dim series1 As New SplineAreaSeries2D()
series1.DisplayName = "Actual"
Dim series2 As New SplineAreaSeries2D()

how-to-display-custom-tooltips-over-the-data-point-currently-hovered-by-the-mouse-pointer-e1376/VB/Window1.xaml.vb#L22

tooltip_text.Text = String.Format("Series = {0}" & Constants.vbLf & "Argument = {1}" & _
    Constants.vbLf & "Value = {2}", point.Series.DisplayName, point.Argument, point.Value)
tooltip1.Placement = PlacementMode.Mouse

how-to-create-a-chart-control-with-a-scrollable-legend-e3565/VB/MainWindow.xaml.vb#L25

areaSeries.Transparency = 0.3
areaSeries.DisplayName = "Area " & (i + 1).ToString()

wpf-charts-show-a-context-menu-for-chart-elements/VB/WpfApplication14/MainWindow.xaml.vb#L30

    Dim series As Series = TryCast(targetObjects(0), Series)
    Title = series.DisplayName
End Sub

how-to-display-check-boxes-for-legend-items-to-control-the-visibility-of-series-in-the-unbou-e2842/VB/MainWindow.xaml.vb#L27

newSeries.Points.Add(New SeriesPoint(1.0, 1.0))
newSeries.DisplayName = "Series" & seriesCount
chart.Diagram.Series.Add(newSeries)