How to set multilevel labels for Excel chart axis in C#, VB.NET?

1 min read

This article explains how to set multilevel labels in chart axis using XlsIO.

How to set multilevel labels in chart axis?

Two or more category labels can be displayed for an axis through Multi-level labels. This can be achieved in XlsIO through NoMultiLevelLabel property in category axis, where multilevel labels can be enabled or disabled in chart.

$C:\Users\kondurukeerthi.kondu\AppData\Local\Microsoft\Windows\INetCache\Content.Word\Capture.png$

Multilevel labels set using XlsIO

Code snippet to set multilevel labels

//Set multilevel label for chart category axis
chart.PrimaryCategoryAxis.NoMultiLevelLabel = false;

Note: Only chart category axis supports multilevel labels whereas value axis does not.

Applicable properties for a chart axis

Below is the list of some of the common properties that are used to format chart axis.

1. CrossesAt

2. NumberFormat

3. Title

4. IsReversed

5. Visible

Download Complete Sample

Download input file with data

To know more about creating charts with various settings using XlsIO, please refer the documentation.

The following C#/ VB.NET complete code snippet shows how to set multilevel labels in chart axis using XlsIO.

using Syncfusion.XlsIO;
using System.Reflection;
using System.IO;
 
namespace ChartSample
{
    class Program
    {
        static void Main(string[] args)
        {
            using (ExcelEngine excelEngine = new ExcelEngine())
            {
                IApplication application = excelEngine.Excel;
                application.DefaultVersion = ExcelVersion.Excel2016;
 
                //Open existing workbook with data entered
                Assembly assembly = typeof(Program).GetTypeInfo().Assembly;
                Stream fileStream = assembly.GetManifestResourceStream("ChartSample.InputTemplate.xlsx");
                IWorkbook workbook = application.Workbooks.Open(fileStream);
                IWorksheet worksheet = workbook.Worksheets[0];
 
                //Initialize chart
                IChartShape chart = worksheet.Charts.Add();
                chart.ChartType = ExcelChartType.Column_Clustered;
 
                //Assign data
                chart.DataRange = worksheet["A1:D7"];
                chart.IsSeriesInRows = false;
 
                //Apply chart elements
                //Set chart title
                chart.ChartTitle = "Clustered Column Chart";
 
                //Set multilevel label for chart category axis
                chart.PrimaryCategoryAxis.NoMultiLevelLabel = false;
                
                //Set data labels
                IChartSerie serie1 = chart.Series[0];
                IChartSerie serie2 = chart.Series[1];
 
                serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = true;
                serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = true;
 
                //Positioning the chart in the worksheet
                chart.TopRow = 8;
                chart.LeftColumn = 1;
                chart.BottomRow = 23;
                chart.RightColumn = 8;
 
                //Saving the workbook
                Stream stream = File.Create("Output.xlsx");
                workbook.SaveAs(stream);
            }
        }
    }
}

Imports Syncfusion.XlsIO
Imports System.Reflection
Imports System.IO
 
Namespace ChartSample
 
    Class Program
 
        Public Shared Sub Main(ByVal args() As String)
            Using excelEngine As ExcelEngine = New ExcelEngine
                Dim application As IApplication = excelEngine.Excel
                application.DefaultVersion = ExcelVersion.Excel2016
 
                'Open existing workbook with data entered
                Dim assembly As Assembly = GetType(Program).GetTypeInfo.Assembly
                Dim fileStream As Stream = assembly.GetManifestResourceStream("ChartSample.InputTemplate.xlsx")
                Dim workbook As IWorkbook = application.Workbooks.Open(fileStream)
                Dim worksheet As IWorksheet = workbook.Worksheets(0)
 
                'Initialize chart
                Dim chart As IChartShape = worksheet.Charts.Add
                chart.ChartType = ExcelChartType.Column_Clustered
 
                'Assign data
                chart.DataRange = worksheet("A1:D7")
                chart.IsSeriesInRows = False
 
                'Apply chart elements
                'Set chart title
                chart.ChartTitle = "Clustered Column Chart"
 
                'Set multilevel label for chart category axis
                chart.PrimaryCategoryAxis.NoMultiLevelLabel = False
 
                'Set data labels
                Dim serie1 As IChartSerie = chart.Series(0)
                Dim serie2 As IChartSerie = chart.Series(1)
 
                serie1.DataPoints.DefaultDataPoint.DataLabels.IsValue = True
                serie2.DataPoints.DefaultDataPoint.DataLabels.IsValue = True
 
                'Positioning the chart in the worksheet
                chart.TopRow = 8
                chart.LeftColumn = 1
                chart.BottomRow = 23
                chart.RightColumn = 8
 
                'Saving the workbook
                Dim stream As Stream = File.Create("Output.xlsx")
                workbook.SaveAs(stream)
            End Using
        End Sub
    End Class
End Namespace

Did you find this information helpful?

Yes

Comments (0)

How to set multilevel labels for Excel chart axis in C#, VB.NET?

Access denied