跳至页脚内容
使用 IRONXL

如何在 C# 中使用 Excel 自动调整单元格

In today's data-driven world, Microsoft Excel remains an indispensable tool for businesses and professionals alike. Whether it's crunching numbers, creating reports, or visualizing data, Excel's versatility is unmatched. However, when it comes to programmatically manipulating Excel files in C#, developers often face challenges. This is where IronXL library comes into play, offering a seamless solution for Excel automation within the C# environment.

IronXL library from Iron Software provides intuitive APIs for handling Excel documents seamlessly in both C# .NET and VB.NET environments. With IronXL, there's no requirement to install Microsoft Office or Excel Interop components. It enables developers to effortlessly read, edit, and create Excel spreadsheet files, offering full support for various .NET frameworks including .NET 8, 7, 6, Core Frameworks, and Azure environments.

In this article, we will learn how to autofit column width and height in Excel using C# and IronXL.

  1. Create a Visual Studio Project to Demo Autofit Cells in Excel worksheet.
  2. Install IronXL library to the project.
  3. Autofit Column width using IronXL library.
  4. Autofit Row height using IronXL library.
  5. Set Column width and Row height Manually using IronXL library.

IronXL

IronXL library is a versatile .NET library designed to simplify Excel spreadsheet manipulation for C# developers. Offering a fast and intuitive API, IronXL enables users to effortlessly access, modify, and generate Excel files without relying on Office Interop. Its compatibility extends to various .NET frameworks, including .NET Core and Azure, without requiring any special dependencies or the installation of Microsoft Office. With support for multiple .NET languages such as C#, VB.NET, and F#, IronXL caters to a wide range of development scenarios, including console, web, and desktop applications. Moreover, IronXL's compatibility spans across different platforms, including Windows, Linux, macOS, Docker, Azure, and AWS, making it an indispensable tool for developers seeking efficient Excel integration across diverse environments.

Key Features of IronXL library

  1. Easy Integration: IronXL seamlessly integrates with C# applications, providing a simple and intuitive API for Excel automation. Developers can quickly get started with a minimal learning curve.
  2. Read and Write Excel Files: With IronXL, you can effortlessly read data from existing Excel files and write data to new or existing spreadsheets. This capability is essential for tasks such as data import/export and report generation.
  3. Formatting and Styling: IronXL enables you to apply formatting and styling to Excel cells, including fonts, colors, borders, and more. This ensures that your generated Excel files maintain a professional and polished appearance.
  4. Formula Support: Need to perform complex calculations or apply formulas to Excel data? IronXL has you covered with support for Excel formulas, allowing you to automate calculations and data manipulation.
  5. Autofit Cells: One of the handy features offered by IronXL is the ability to autofit cells in Excel, ensuring that the content fits neatly within each cell without truncation.

Step 1: Create a Visual Studio Project to Demo Autofit Cells in Excel worksheet.

To get started, let's create a Visual Studio project as shown below. Select the Console application template from the list

How to Autofit Cells in Excel Using C#: Figure 1 - Open Visual Studio, and Add a new project of type Console Application in C#.

Provide a project name and location

How to Autofit Cells in Excel Using C#: Figure 2 - Next, specify Project name and Location.

Select the required .NET version from the dropdown and click create

How to Autofit Cells in Excel Using C#: Figure 3 - Then, select the required .NET Framework version and click on Create.

Step 2: Install IronXL library to the project.

Install IronXL library from Visual Studio NuGet Package Manager

How to Autofit Cells in Excel Using C#: Figure 4 - Install IronXL using the Manage NuGet Package for Solution by searching "IronXL" in the search bar of NuGet Package Manager, then select the project and click on the Install button.

The package can also be installed using the NuGet Command line

dotnet add package IronXL.Excel --version 2024.3.20
# or
Install-Package IronXL.Excel
dotnet add package IronXL.Excel --version 2024.3.20
# or
Install-Package IronXL.Excel
SHELL

How to Autofit Cells in Excel Using C#: Figure 5 - IronXL.Excel NuGet package

With this, we are ready to start coding.

Step 3: Autofit Column width using IronXL library

The AutoSizeColumn method from IronXL library adjusts the width of a column to fit its content. This method calculates the text width based on the font used in the cell. If the exact font isn't available on the system, it will attempt to measure it using a default font. If no default font is found, it will try to utilize any available font. However, if no fonts are found, an exception will be thrown. It uses a zero-based column index as a parameter. It must be within the bounds defined by 0 and (ColumnCount - 1). ArgumentException is thrown if the provided columnIndex is outside the valid range. SixLabors.Fonts.FontException is thrown when no fonts are installed on the machine.

Now, let's see how we can use this to resize an Excel file. You can download a sample Excel file from here.

Input File

Here you can see the column widths are not properly defined and hence very difficult to read. Now let's
see how we can use the IronXL library to Autofit column widths in an excel sheet.

How to Autofit Cells in Excel Using C#: Figure 6 - Input Excel file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var colCount = workSheet.Columns.Count();

for (int i = 0; i < colCount; i++)
{ 
    // Auto-fit column width for index i
    workSheet.AutoSizeColumn(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx"); // Result file
using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var colCount = workSheet.Columns.Count();

for (int i = 0; i < colCount; i++)
{ 
    // Auto-fit column width for index i
    workSheet.AutoSizeColumn(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx"); // Result file
Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private colCount = workSheet.Columns.Count()

For i As Integer = 0 To colCount - 1
	' Auto-fit column width for index i
	workSheet.AutoSizeColumn(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResize.xlsx") ' Result file
$vbLabelText   $csharpLabel

Code Explanation

  1. Initially, we load the FinancialSample.xlsx using the WorkBook.Load() method.
  2. Then we get the count of columns for adjustments.
  3. We iterate through all column indexes to auto-size the column widths.
  4. Finally, we save the results to a new file named autoResize.xlsx.

Output File

Below you can see all the columns are auto-sized and visible.

How to Autofit Cells in Excel Using C#: Figure 7 - Output excel with auto-sized column width.

Step 4: Autofit Row height using IronXL library

The AutoSizeRow method adjusts the height of a row to accommodate its content. It's important to note that this method calculates the text height based on the font used in the cell. If the exact font isn't available on the system, it will attempt to measure it using a default font. If no default font is found, it will try to utilize any available font. However, if no fonts are found, an exception will be thrown. It uses a zero-based row index as a parameter. It must be within the bounds defined by 0 and (RowCount - 1). ArgumentException is thrown if the provided rowIndex is outside the valid range. SixLabors.Fonts.FontException is thrown when no fonts are installed on the machine.

Input Excel File

In the below example, you can see some of the rows are not sized to fix the data appropriately. Now let's look into the C# code to autofit Excel row heights.

How to Autofit Cells in Excel Using C#: Figure 8 - Input Excel file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var rowCount = workSheet.RowCount;

for (int i = 0; i < rowCount; i++)
{
    // Auto-fit row height for index i
    workSheet.AutoSizeRow(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx"); // Result file
using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
var rowCount = workSheet.RowCount;

for (int i = 0; i < rowCount; i++)
{
    // Auto-fit row height for index i
    workSheet.AutoSizeRow(i);
}

// Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx"); // Result file
Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private rowCount = workSheet.RowCount

For i As Integer = 0 To rowCount - 1
	' Auto-fit row height for index i
	workSheet.AutoSizeRow(i)
Next i

' Save the autofitted workbook as a new file
workBook.SaveAs("autoResizeRows.xlsx") ' Result file
$vbLabelText   $csharpLabel

Code Explanation

  1. Initially, we load the FinancialSample.xlsx using the WorkBook.Load() method.
  2. We retrieve the total row count.
  3. We iterate through all row indexes to auto-size the row heights.
  4. Finally, we save the results to a new file named autoResizeRows.xlsx.

Output Excel File

How to Autofit Cells in Excel Using C#: Figure 9 - Output excel with auto-sized row height.

Step 5: Set Column width and Row height Manually using IronXL

In addition to auto-sizing rows and columns, IronXL also offers the option to manually adjust the width and height to a specific row height value and specific column width value.

Input Excel File

How to Autofit Cells in Excel Using C#: Figure 10 - Input Excel file

using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Manually set row height and column width
RangeRow row = workSheet.GetRow(0);
row.Height = 500; // Set height
RangeColumn col = workSheet.GetColumn(0);
col.Width = 5000; // Set width

// Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx");
using IronXL;
// Load example spreadsheet
WorkBook workBook = WorkBook.Load("FinancialSample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Manually set row height and column width
RangeRow row = workSheet.GetRow(0);
row.Height = 500; // Set height
RangeColumn col = workSheet.GetColumn(0);
col.Width = 5000; // Set width

// Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx");
Imports IronXL
' Load example spreadsheet
Private workBook As WorkBook = WorkBook.Load("FinancialSample.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet

' Manually set row height and column width
Private row As RangeRow = workSheet.GetRow(0)
row.Height = 500 ' Set height
Dim col As RangeColumn = workSheet.GetColumn(0)
col.Width = 5000 ' Set width

' Save the workbook with specific values set
workBook.SaveAs("specificValue.xlsx")
$vbLabelText   $csharpLabel

Code Explanation

  1. Load the FinancialSample.xlsx using the WorkBook.Load() function.
  2. Retrieve specific rows and columns to manually adjust their height and width.
  3. Set the desired height and width values.
  4. Save the modified file with the name specificValue.xlsx.

Output Excel File

How to Autofit Cells in Excel Using C#: Figure 11 - Output excel with manual-sized column width and height.

Licensing

Obtain a free trial to freely use all of IronXL features for 30 days.

The obtained license has to be placed in the appSettings.json file:

{
  "IronXL.License.LicenseKey": "myTrialKey"
}

Conclusion

With features like AutoSizeColumn and AutoSizeRow from IronXL, developers can effortlessly ensure that Excel spreadsheets dynamically adjust to the content they contain, whether it's imported data, dynamic reports, user-generated content, or data analysis results.

IronXL's compatibility with various .NET frameworks, including .NET Core and Azure, ensures that developers can incorporate Excel automation into a wide range of applications without dependencies on Microsoft Office or Excel Interop. Moreover, IronXL's support for multiple .NET languages and platforms makes it a versatile choice for developers seeking to streamline Excel manipulation tasks across diverse environments.

In essence, IronXL empowers developers to enhance productivity, accuracy, and flexibility in Excel automation projects, offering a comprehensive suite of features to meet the demands of modern C# development. Whether it's generating reports, analyzing data, or presenting information, IronXL provides the tools necessary to excel in Excel automation within the C# ecosystem.

常见问题解答

我如何在Excel中使用C#自动调整单元格的大小?

要在Excel中使用C#自动调整单元格的大小,可以使用IronXL的AutoSizeColumnAutoSizeRow方法,它们会自动调整列宽和行高以适应内容。

使用.NET库进行Excel自动化的好处是什么?

使用像IronXL这样的.NET库来进行Excel自动化,可以简化读取、写入和格式化Excel文件等任务,无需安装Microsoft Office。这提升了C#应用程序的生产力和准确性。

我如何在Excel中手动调整列宽和行高,使用C#?

使用IronXL,你可以通过GetColumnGetRow方法来手动调整列宽和行高,以针对特定的列和行,然后设置它们的WidthHeight属性。

IronXL是否兼容.NET Core项目?

是的,IronXL完全兼容.NET Core项目,允许开发人员在现代.NET环境中无缝集成Excel自动化功能。

如何在 .NET 项目中安装 IronXL?

要在.NET项目中安装IronXL,请使用Visual Studio的NuGet包管理器或在命令行中运行命令dotnet add package IronXL.Excel

我可以在不安装Excel的情况下使用IronXL吗?

是的,IronXL允许你在不需要安装Microsoft Excel的情况下,在C#中以编程方式处理Excel文件。

如果我在自动调整单元格时遇到字体异常,该怎么办?

如果你在自动调整单元格时遇到SixLabors.Fonts.FontException,请确保系统上有必要的字体,因为IronXL使用这些字体来计算文本尺寸。

IronXL如何支持多种.NET语言?

IronXL支持包括C#、VB.NET和F#在内的多种.NET语言,为在不同编程环境中工作的开发人员提供灵活性和多样性。

我应该在项目中哪里添加IronXL的许可证密钥?

IronXL的许可证密钥应添加到项目的appSettings.json文件中,键为'IronXL.License.LicenseKey',以激活高级功能。

IronXL在Excel自动化中有哪些关键功能?

IronXL提供了关键功能,如与C#应用程序的轻松集成、读取和写入Excel文件、应用格式、支持Excel公式以及自动调整单元格以优化内容显示。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

除了开发之外,Curtis 对物联网 (IoT) 有浓厚的兴趣,探索将硬件和软件集成的新方法。在空闲时间,他喜欢玩游戏和构建 Discord 机器人,将他对技术的热爱与创造力相结合。