A newer version of this page is available. Switch to the current version.


  • 4 minutes to read

This document details the specifics of the XY-Diagram type. It lists the series view types associated with this diagram type, demonstrates how its specific options can be accessed (both at design and runtime), and briefly describes these options. Before reading this text, you may wish to review the basics of using diagram in the ASP.NET Chart Control.

This document consists of the following sections.

Associated Series View Types

The XY-Diagram is the most common diagram type, since it is used to plot the series which are displayed using both axes: the axis of arguments (X-axis) and the axis of values (Y-axis). There are many such series view types available in the WebChartControl. You can freely plot multiple series of these view types together, within the same diagram object, as shown in the following image.


In particular, the XY-Diagram is used to plot series of the following view types:

Accessing a Diagram

To access the XY-Diagram’s options at design time, click your chart, to select it. Then, in the Properties window, expand the WebChartControl.Diagram property.


At runtime, cast your instance of the Diagram object to the XYDiagram type.

// Create a new WebChartControl instance.
WebChartControl chart = new WebChartControl();

// Create a series of a compatible view type, 
// and add it to the chart's collection,
// so the diagram object shall not to be equal to null.
Series series1 = new Series("Line Series 1", ViewType.Line);

// Create a diagram, and cast it to the XYDiagram type.
XYDiagram diagram = (XYDiagram)chart.Diagram;

// Access the diagram's options.
diagram.Rotated = true;
diagram.DefaultPane.BackColor = Color.Aqua;

Specific Options

The available options, specific for the XY-Diagram type, are briefly described below. For the more detailed information about them, refer to these properties’ descriptions.

In addition, it is possible to control the diagram’s appearance. Since XY-Diagram supports panes, there is a difference on how the appearance properties of this diagram are accessed. So, for the default pane, they can be accessed via the XYDiagram2D.DefaultPane property, as shown in the following image.


These properties are listed below. Note that these properties are also available for additional panes, the collection of which can be accessed via the XYDiagram2D.Panes property.

See Also