Xceed Workbooks for .NET v3.0 Documentation
Xceed.Workbooks.NET Assembly / Xceed.Workbooks.NET Namespace / BarSeries Class
Members Example


In This Topic
    BarSeries Class
    In This Topic
    Encapsulates Series of the Bar type. 
    Syntax
    'Declaration
     
    
    Public Class BarSeries 
       Inherits ColumnSeries
    'Usage
     
    
    Dim instance As BarSeries
    public class BarSeries : ColumnSeries 
    Remarks
    This is usually used in BarCharts or Bar3DCharts.
    Example

    The code below would display the following Chart:

     

    var workbook = Workbook.Create( ChartSample.ChartSampleOutputDirectory + @"AddCharts.xlsx" );
    
    // Gets the first Worksheet. A Workbook always contains at least 1 Worksheet.
    var worksheet = workbook.Worksheets[ 0 ];
    
    // Adds Values for Category.
    worksheet.Cells[ "B4" ].Value = 2020;
    worksheet.Cells[ "B5" ].Value = 2021;
    worksheet.Cells[ "B6" ].Value = 2022;
    worksheet.Cells[ "B7" ].Value = 2023;
    worksheet.Cells[ "B8" ].Value = 2024;
    
    // Adds Values for Series.
    worksheet.Cells[ "C4" ].Value = 20;
    worksheet.Cells[ "C5" ].Value = 28;
    worksheet.Cells[ "C6" ].Value = 33;
    worksheet.Cells[ "C7" ].Value = 12;
    worksheet.Cells[ "C8" ].Value = 45;
    
    // Adds a BarChart with the generic Add method and set its SubType. The size of the Chart will be from Cell E4 to L18.
    var barChart = worksheet.Charts.Add<BarChart>( "E4", "L18" );
    barChart.SubType = BarChartSubType.Clustered;
    
    // Sets the Chart's Title.
    barChart.Title.Text = "Profits";
    barChart.Title.TextOptions.Font.Bold = true;
    
    // Sets the Legend.
    barChart.Legend.Position = LegendPositionType.Right;
    
    // Sets the Category data(x values) for the BarChart : Cells B4 to B8.
    barChart.CategoryData = CategoryData.FromCells( worksheet, "B4", "B8" );
    
    // Sets Axis titles and shows them.
    barChart.CategoryAxis.Title.IsVisible = true;
    barChart.CategoryAxis.Title.Text = "Years";
    barChart.ValueAxis.Title.IsVisible = true;
    barChart.ValueAxis.Title.Text = "Profits(in M$)";
    
    // Sets the width between the Bar groups to 50%.
    barChart.GapWidth = 50;
    
    // Adds BarSeries to the BarChart (y values) by specifying fixed values and a range of Cells’ Adresses.
    var barSeries1 = barChart.SeriesCollection.AddFromValues<BarSeries>( 5, 10, 15, 20, 40 );
    barSeries1.Name = "IBM";
    var barSeries2 = barChart.SeriesCollection.AddFromCells<BarSeries>( "C4", "C8" );
    barSeries2.Name = "Apple";
    
    // Customizes the barSeries.
    barSeries1.Fill.Color = Xceed.Drawing.Color.Blue;
    barSeries2.Fill.Color = Xceed.Drawing.Color.Yellow;
    barSeries2.Stroke.Color = Xceed.Drawing.Color.Orange;
    
    // Customizes and shows the DataPoint Labels for the BarSeries.
    barSeries1.DataPointLabels.ShowValue = true;
    barSeries1.DataPointLabels.Position = SurfaceDataPointLabelsPositionType.OutsideEnd;
    barSeries1.DataPointLabels.TextOptions.TextFill.Color = Xceed.Drawing.Color.Blue;
    barSeries2.DataPointLabels.ShowValue = true;
    barSeries2.DataPointLabels.Position = SurfaceDataPointLabelsPositionType.OutsideEnd;
    barSeries2.DataPointLabels.TextOptions.TextFill.Color = Xceed.Drawing.Color.Orange;
    
    // Saves Workbook to disk.
    workbook.Save();
    Inheritance Hierarchy

    System.Object
       Xceed.Workbooks.NET.WorkbookElement
          Xceed.Workbooks.NET.WorksheetElement
             Xceed.Workbooks.NET.ChartValueRange
                Xceed.Workbooks.NET.Series
                   Xceed.Workbooks.NET.ColumnSeries
                      Xceed.Workbooks.NET.BarSeries

    Requirements

    Target Platforms: Windows 11, Windows 10, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also