ASP.NET Chart Setting Explicit Items

The data that will be displayed in the ShieldChart can be declared explicitly in several ways:

  • Declarative Creation- Setting items in the markup (statically) using the Items collection of each series.
    <shield:ShieldChart ID="ShieldChart1" Width="100%" Height="400px" runat="server"
        CssClass="chart">
        <DataSeries>
            <shield:ChartBarSeries>
                <Items>
                    <shield:ChartSeriesItem ValueY="1" ValueX="1" />
                    <shield:ChartSeriesItem ValueY="2" ValueX="2" />
                    <shield:ChartSeriesItem ValueY="3" ValueX="3" Color="Green" />
                    <shield:ChartSeriesItem ValueY="4" ValueX="4" />
                    <shield:ChartSeriesItem ValueY="5" ValueX="5" />
                </Items>
            </shield:ChartBarSeries>
        </DataSeries>
    </shield:ShieldChart>
    
    • Programmatic Creation - SeriesItems can be created on the server like any other objects, then added to the Items collection of the desired series.
      protected override void OnLoad(EventArgs e)
      {
          base.OnLoad(e);
      
          ChartBarSeries barSeries = ShieldChart1.DataSeries[0] as ChartBarSeries;
          ChartSeriesItem item = new ChartSeriesItem();
          item.ValueY = 1;
          item.ValueX = 1;
          barSeries.Items.Add(item);
      
          item = new ChartSeriesItem();
          item.ValueY = 2;
          item.ValueX = 2;
          barSeries.Items.Add(item);
      
          item = new ChartSeriesItem();
          item.ValueY = 3;
          item.ValueX = 3;
          item.Color = Color.Green;
          barSeries.Items.Add(item);
      
          item = new ChartSeriesItem();
          item.ValueY = 4;
          item.ValueX = 4;
          barSeries.Items.Add(item);
      
          item = new ChartSeriesItem();
          item.ValueY = 5;
          item.ValueX = 5;
          barSeries.Items.Add(item);
      }
      

      Example of programmatic chart creation can be found on the Programmatic Creationdemo.

      • Declarative and Programmatic Creation - Series items can be created programmatically and then added to an existing series items collection that is set in the markup. Series items set in the markup can also be accessed and modified from the code behind.
        NOTE: If the chart has both explicit items and it is data bound to a specific data source in order to append explicitly added items you need to set ShieldChart.AppendDataBoundItems to "true".
        <shield:ShieldChart ID="ShieldChart1" Width="100%" Height="400px" runat="server"
            CssClass="chart" AppendDataBoundItems="true">
            …
        

        Example of adding declarative items can be found on the Append Databound Itemsdemo.