Passer au contenu du pied de page
UTILISATION D'IRONXL

Comment ajuster automatique les cellules d'Excel en utilisant C#

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.

Questions Fréquemment Posées

Comment puis-je ajuster automatiquement la taille des cellules dans Excel en utilisant C# ?

Pour ajuster automatiquement la taille des cellules dans Excel en utilisant C#, utilisez les méthodes AutoSizeColumn et AutoSizeRow de IronXL, qui ajustent automatiquement les largeurs de colonne et les hauteurs de ligne en fonction du contenu.

Quels sont les avantages d'utiliser une bibliothèque .NET pour l'automatisation d'Excel ?

L'utilisation d'une bibliothèque .NET comme IronXL pour l'automatisation d'Excel simplifie des tâches telles que la lecture, l'écriture et le formatage des fichiers Excel sans nécessiter d'installations de Microsoft Office. Cela améliore la productivité et la précision dans les applications C#.

Comment puis-je ajuster manuellement la largeur des colonnes et la hauteur des lignes dans Excel en utilisant C# ?

Avec IronXL, vous pouvez ajuster manuellement la largeur des colonnes et la hauteur des lignes en utilisant les méthodes GetColumn et GetRow pour cibler des colonnes et des lignes spécifiques, puis définir leurs propriétés Width et Height.

IronXL est-il compatible avec les projets .NET Core ?

Oui, IronXL est entièrement compatible avec les projets .NET Core, permettant aux développeurs d'intégrer des fonctionnalités d'automatisation d'Excel de manière transparente dans les environnements .NET modernes.

Comment installer IronXL dans un projet .NET ?

Pour installer IronXL dans un projet .NET, utilisez le gestionnaire de packages NuGet de Visual Studio ou exécutez la commande dotnet add package IronXL.Excel en ligne de commande.

Puis-je utiliser IronXL sans avoir Excel installé sur ma machine ?

Oui, IronXL vous permet de travailler avec des fichiers Excel de manière programmatique en C# sans nécessiter l'installation de Microsoft Excel sur votre machine.

Que dois-je faire si je rencontre une exception de police lors de l'ajustement automatique des cellules ?

Si vous rencontrez une SixLabors.Fonts.FontException lors de l'ajustement automatique des cellules, assurez-vous que les polices nécessaires sont disponibles sur votre système, car IronXL les utilise pour calculer les dimensions du texte.

Comment IronXL prend-il en charge plusieurs langages .NET ?

IronXL prend en charge plusieurs langages .NET tels que C#, VB.NET et F#, offrant polyvalence et flexibilité aux développeurs travaillant dans différents environnements de programmation.

Où dois-je ajouter la clé de licence IronXL dans mon projet ?

La clé de licence IronXL doit être ajoutée au fichier appSettings.json de votre projet sous la clé 'IronXL.License.LicenseKey' pour activer les fonctionnalités premium.

Quelles sont certaines des fonctionnalités clés d'IronXL pour l'automatisation d'Excel ?

IronXL offre des fonctionnalités clés telles que l'intégration facile avec des applications C#, la lecture et l'écriture de fichiers Excel, l'application de formatages, le support des formules Excel, et l'ajustement automatique des cellules pour optimiser l'affichage du contenu.

Jordi Bardia
Ingénieur logiciel
Jordi est le plus compétent en Python, C# et C++, et lorsqu'il ne met pas à profit ses compétences chez Iron Software, il programme des jeux. Partageant les responsabilités des tests de produit, du développement de produit et de la recherche, Jordi apporte une immense valeur à l'amé...
Lire la suite