IXlSheet.CreateColumn() Method

Creates a new column in the worksheet and returns the IXlColumn object.

Namespace: DevExpress.Export.Xl

Assembly: DevExpress.Printing.v20.2.Core.dll

NuGet Packages: DevExpress.Printing.Core, DevExpress.WindowsDesktop.Printing.Core

Declaration

C#

IXlColumn CreateColumn()

VB.NET

Function CreateColumn As IXlColumn

Returns

Type	Description
IXlColumn	An IXlColumn object that is the newly created column.

Remarks

Columns in a worksheet should be created prior to rows and cells. If you try to create a column after or during the row generation, an InvalidOperationException exception will be thrown.

Example

The example below demonstrates how to create and modify a column in a worksheet. To do this, use the IXlSheet.CreateColumn method. To specify where a created column should be located in a worksheet, pass a zero-based column index to the method as a parameter.

C#

// Create a new worksheet.
using (IXlSheet sheet = document.CreateSheet())
{
    // Create the column "A" and set its width to 100 pixels.
    using (IXlColumn column = sheet.CreateColumn())
    {
        column.WidthInPixels = 100;
    }

    // Create the column D and set its width to 24.5 characters.
    using (IXlColumn column = sheet.CreateColumn(3))
    {
        column.WidthInCharacters = 24.5f;
    }
}

VB.NET

' Create a new worksheet.
Using sheet As IXlSheet = document.CreateSheet()
    ' Create the column "A" and set its width to 100 pixels.
    Using column As IXlColumn = sheet.CreateColumn()
        column.WidthInPixels = 100
    End Using

    ' Create the column D and set its width to 24.5 characters.
    Using column As IXlColumn = sheet.CreateColumn(3)
        column.WidthInCharacters = 24.5F
    End Using
End Using

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the CreateColumn() method.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-use-the-excel-export-api-to-generate-a-list-of-employees-t251723/CS/XLExportExample/Form1.cs#L168

// Create the "Employee ID" column and set its width.
using (IXlColumn column = sheet.CreateColumn())
    column.WidthInPixels = 110;

how-to-copy-cell-data-in-an-excel-format-biff8-to-the-clipboard-using-xl-export-library-t266171/CS/gridCopyToClipboardExample/CopyToClipboardHelper.cs#L30

using (IXlColumn column = sheet.CreateColumn()) {
    // Setup number format

VB.NET

how-to-use-the-excel-export-api-to-generate-a-list-of-employees-t251723/VB/XLExportExample/Form1.vb#L181

' Create the "Employee ID" column and set its width.
Using column As IXlColumn = sheet.CreateColumn()
    column.WidthInPixels = 110

how-to-copy-cell-data-in-an-excel-format-biff8-to-the-clipboard-using-xl-export-library-t266171/VB/gridCopyToClipboardExample/CopyToClipboardHelper.vb#L32

Using column As IXlColumn = sheet.CreateColumn()
    ' Setup number format