Charting in Silverlight

This tutorial demonstrates how to use charting applications in Silverlight using Silverlight Toolkit. First you will learn how to get started with the Silverlight Toolkit and then create bar chart, line chart, pie chart, column chart, and scatter chart in a Silverlight application.


Charting in Silverlight

The Silverlight Toolkit released on November 2008 comes with a data visualization assembly called Microsoft.Windows.Controls.DataVisualization.dll that hosts the functionality related to charts in Silverlight.  This article demonstrates how to draw charts using the Silverlight Toolkit.

Note: This article is written by using the Silverlight Toolkit November 2008 that you can download from here: Silverlight Toolkit - Release: Silverlight Toolkit November 2008. This control may be a part of Silverlight in near future versions.

Adding Silverlight Toolkit Reference

Before you can use any charting related functionality in a Silverlight application, you must download the Silverlight Toolkit. After that you need to add a reference to an assembly.

 

To add a reference, right click the References folder of your project in Solution Explorer and select Add Reference. This action will open the Add Reference dialog as you can in the following Figure 1. On this dialog, select Browse option and browse the Microsoft.Windows.Controls.DataVisualization.dll assembly from the folder where you installed the Silverlight Toolkit. This assembly resides in the Binaries folder.  

ChartingImg1.gif

Figure 1

Once you add the reference, you will see the Microsoft.Windows.Controls.DataVisualization added to your References dialog as you see in Figure 2.

ChartingImg2.gif

Figure 2

Now, the next step is to import the Microsoft.Windows.Controls.DataVisualization and the Microsoft.Windows.Controls.DataVisualization.Charting namespaces to the page.  Once you type xmlns= in your page, you will see these namespaces in the Intellisense. Select and add both of them to your page as you can see in Figure 3.

ChartingImg3.gif

Figure 3

The final reference added to the page looks like following. As you can see here, I added name of this reference to ToolkitRef.

xmlns:DV="clr-namespace:Microsoft.Windows.Controls.DataVisualization;assembly=Microsoft.Windows.Controls.DataVisualization"

 xmlns:DVC="clr-namespace:Microsoft.Windows.Controls.DataVisualization.Charting;assembly=Microsoft.Windows.Controls.DataVisualization"

 

Now you will see ToolkitRef in your page and once you select it, you will notice all Charting related elements added to the Intellisense. To add a Chart control to your page, just select the Chart control from the list. The list of charting related elements looks like Figure 4.

ChartingImg4.gif

Figure 4

Creating a Chart

The Chart element represents a Silverlight Chart control in XAML.

 

< DVC:Chart></DVC:Chart>

 

The code snippet in Listing 1 creates a Chart and sets its width, height, and background properties of the Chart control.    

<DVC:Chart x:Name="MyChart" Width="400" Height="250"

           Background="YellowGreen" >           

</DVC:Chart>

 

Listing 1

 

The output of Listing 1 looks like Figure 5.

 

ChartingImg5.gif

Figure 5

Chart Types

The Series attribute of the Chart element is used to create a chart type. If you see in Figure 6, you will notice BarSeries, ColumnSeries, LineSeries, PieSeries, and ScatterSeries attributes and based on the attribute, the chart will be created.

 

ChartingImg6.gif

Figure 6

 

Bar Chart

The code snippet in Listing 2 creates a bar chart by setting Chart.Series to BarSeries. As you see, the binding is occurred on Key and Value fields of a data source.

 

<DVC:Chart Canvas.Top="80" Canvas.Left="10" x:Name="mcChart"

           Width="400" Height="250"

           Background="LightSteelBlue">

    <DVC:Chart.Series>

        <DVC:BarSeries Title="Experience"

            IndependentValueBinding="{Binding Path=Key}"

            DependentValueBinding="{Binding Path=Value}">                   

        </DVC:BarSeries>

     </DVC:Chart.Series>           

</DVC:Chart>   

Listing 2

The code snippet in Listing 3 creates a collection in KeyValuePair form and sets the ItemsSource property of the chart series. Same data can be used for other chart types.

 

private void LoadBarChartData()

{

    ((BarSeries)mcChart.Series[0]).ItemsSource =

        new KeyValuePair<string, int>[]{

            new KeyValuePair<string, int>("Project Manager", 12),

            new KeyValuePair<string, int>("CEO", 25),

            new KeyValuePair<string, int>("Software Engg.", 5),

            new KeyValuePair<string, int>("Team Leader", 6),

            new KeyValuePair<string, int>("Project Leader", 10),

            new KeyValuePair<string, int>("Developer", 4) };

}

Listing 3

The output looks like Figure 7.

 

ChartingImg7.gif

Figure 7

Column Chart

The code snippet in Listing 4 creates a column chart by setting Chart.Series to ColumnSeries. As you may see, the binding is occurred on Key and Value fields of a data source.

 

<DVC:Chart Canvas.Top="80" Canvas.Left="10" x:Name="mcChart"

           Width="400" Height="250"

           Background="LightSteelBlue">

    <DVC:Chart.Series>

     <DVC:ColumnSeries Title="Experience"

      IndependentValueBinding="{Binding Path=Key}"

      DependentValueBinding="{Binding Path=Value}">

</DVC:ColumnSeries>           

</DVC:Chart>           

Listing 4

The code snippet in Listing 5 creates a collection in KeyValuePair form and sets the ItemsSource property of the chart series. Same data can be used for other chart types.

 

private void LoadColumnChartData()

{

((ColumnSeries)mcChart.Series[0]).ItemsSource =

    new KeyValuePair<string, int>[]{

        new KeyValuePair<string, int>("Project Manager", 12),

        new KeyValuePair<string, int>("CEO", 25),

        new KeyValuePair<string, int>("Software Engg.", 5),

        new KeyValuePair<string, int>("Team Leader", 6),

        new KeyValuePair<string, int>("Project Leader", 10),

        new KeyValuePair<string, int>("Developer", 4) };

}

Listing 5

The output looks like Figure 8.

 

ChartingImg8.gif

Figure 8

Pie Chart

The code snippet in Listing 6 creates a pie chart by setting Chart.Series to BarSeries. As you may see, the binding is occurred on Key and Value fields of a data source.

 

<DVC:Chart Canvas.Top="80" Canvas.Left="10" x:Name="mcChart"

           Width="400" Height="250"

           Background="LightSteelBlue">

    <DVC:Chart.Series>

     <DVC:PieSeries Title="Experience"

            IndependentValueBinding="{Binding Path=Key}"

            DependentValueBinding="{Binding Path=Value}">

        </DVC:PieSeries>

    </DVC:Chart.Series>           

</DVC:Chart>           

Listing 6

The code snippet in Listing 7 creates a collection in KeyValuePair form and sets the ItemsSource property of the chart series. Same data can be used for other chart types.

 

private void LoadPieChartData()

{

    ((PieSeries)mcChart.Series[0]).ItemsSource =

        new KeyValuePair<string, int>[]{

            new KeyValuePair<string, int>("Project Manager", 12),

            new KeyValuePair<string, int>("CEO", 25),

            new KeyValuePair<string, int>("Software Engg.", 5),

            new KeyValuePair<string, int>("Team Leader", 6),

            new KeyValuePair<string, int>("Project Leader", 10),

            new KeyValuePair<string, int>("Developer", 4) };

}

Listing 7

The output looks like Figure 9.

 

ChartingImg9.gif

Figure 9

Line Chart

The code snippet in Listing 8 creates a line chart by setting Chart.Series to LineSeries. As you may see, the binding is occurred on Key and Value fields of a data source.

 

<DVC:Chart Canvas.Top="80" Canvas.Left="10" x:Name="mcChart"

           Width="400" Height="250"

           Background="LightSteelBlue">

    <DVC:Chart.Series>

     <DVC:LineSeries Title=" Monthly Count"

            IndependentValueBinding="{Binding Path=Key}"

            DependentValueBinding="{Binding Path=Value}">

</DVC:LineSeries>

    </DVC:Chart.Series>           

</DVC:Chart>           

Listing 8

The code snippet in Listing 9 creates a collection in KeyValuePair form and sets the ItemsSource property of the chart series. Same data can be used for other chart types.

 

private void LoadLineChartData()

{

    ((LineSeries)mcChart.Series[0]).ItemsSource =

        new KeyValuePair<DateTime, int>[]{

            new KeyValuePair<DateTime, int>(DateTime.Now, 100),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(1), 130),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(2), 150),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(3), 125),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(4), 155) };

 

Listing 9

The output looks like Figure 10.

ChartingImg10.gif 

Figure 10

Scatter Chart

The code snippet in Listing 9 creates a scatter chart by setting Chart.Series to ScatterSeries. As you may see, the binding is occurred on Key and Value fields of a data source.

 

<DVC:Chart Canvas.Top="80" Canvas.Left="10" x:Name="mcChart"

           Width="400" Height="250"

           Background="LightSteelBlue">

    <DVC:Chart.Series>

     <DVC:ScatterSeries Title="Dots"

            IndependentValueBinding="{Binding Path=Key}"

            DependentValueBinding="{Binding Path=Value}">

</DVC:ScatterSeries>

    </DVC:Chart.Series>           

</DVC:Chart>           

Listing 9

The code snippet in Listing 10 creates a collection in KeyValuePair form and sets the ItemsSource property of the chart series. Same data can be used for other chart types.

 

private void LoadScatterChartData()

{

   

    ((ScatterSeries)mcChart.Series[0]).ItemsSource =

        new KeyValuePair<DateTime, int>[]{

            new KeyValuePair<DateTime, int>(DateTime.Now, 100),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(1), 130),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(2), 150),

            new KeyValuePair<DateTime, int>(DateTime.Now.AddMonths(3), 125)

            };

}

Listing 10

The output looks like Figure 11.

ChartingImg11.gif 

Figure 11

 Summary

This tutorial discusses how to the Silverlight Toolkit to create various charts including a bar chart, column chart, pie chart, scatter chart and a line chart.