How to create a defined name for discontinuous range of cells in a worksheet using C#, VB.NET?

Syncfusion Excel (XlsIO) library is a .NET Excel library used to create, read, and edit Excel documents. Using this library, you can define a name to both continuous and discontinuous range of cells in a worksheet.

This article explains how to create a defined name for discontinuous range of cells in a worksheet using C# and VB.NET.

Include the following namespace in the Program.cs file.

C#

using Syncfusion.XlsIO;

VB.NET

Imports Syncfusion.XlsIO

Use the following code snippet for creating a defined name for discontinuous range of cells in a worksheet.

C#

using (ExcelEngine excelEngine = new ExcelEngine())
{
    IApplication application = excelEngine.Excel;
    application.DefaultVersion = ExcelVersion.Xlsx;
    IWorkbook workbook = application.Workbooks.Create(1);
    IWorksheet sheet = workbook.Worksheets[0];

    //Create a range collection for discontinuous cells
    IRanges ranges = sheet.CreateRangesCollection();

    //Add different ranges to the collection
    ranges.Add(sheet["D2:D3"]);
    ranges.Add(sheet["D10:D11"]);

    //Create a named range with the collection
    workbook.Names.Add("test", ranges);

    #region Save
    //Saving the workbook
    FileStream outputStream = new FileStream(Path.GetFullPath("Output.xlsx"), FileMode.Create, FileAccess.Write);
    workbook.SaveAs(outputStream);
    #endregion

    //Dispose streams
    outputStream.Dispose();
}

VB.NET

Using excelEngine As ExcelEngine = New ExcelEngine()
    Dim application As IApplication = excelEngine.Excel
    application.DefaultVersion = ExcelVersion.Xlsx
    Dim workbook As IWorkbook = application.Workbooks.Create(1)
    Dim worksheet As IWorksheet = workbook.Worksheets(0)

    'Create a range collection for discontinuous cells
    Dim range As IRanges = worksheet.CreateRangesCollection()

    'Add different ranges to the collection
    range.Add(worksheet.Range("D2:D3"))
    range.Add(worksheet.Range("D10:D11"))

    'Create a named range with the collection
    workbook.names.add("test", range)

    'Saving the workbook
    workbook.SaveAs("Output.xlsx")
End Using 

You can get the complete sample for creating a defined name for discontinuous range of cells in a worksheet from here.

I hope you enjoyed learning about how to create a defined name for discontinuous range of cells in a worksheet using C# and VB.NET in XlsIO.

You can refer to our XIsIO’s feature tour page to learn about its other groundbreaking features. Explore our UG documentation and online demos to understand how to manipulate data in Excel documents.

If you are an existing user, you can access our latest components from the License and Downloads page. For new users, you can try our 30-day free trial to check out XlsIO and other Syncfusion components.

If you have any queries or require clarification, please let us know in the comments below or contact us through our support forums, Support Tickets, or feedback portal. We are always happy to assist you!

Take a moment to peruse the documentation where you can find basic Excel document processing options along with the features like import and export data, chart, formulas, conditional formatting, data validation, tables, pivot tables and, protect the Excel documents, and most importantly, the PDF, CSV and Image conversions with code examples.