Saltar al pie de página
USANDO IRONXL

Cómo escribir un archivo CSV en C#

This article will introduce how to write CSV files using a C# library named IronXL in a new project.

How to Write a CSV File

  1. Install the C# library for writing into a CSV File.

  2. Use WorkBook.Create to create a new workbook.

  3. Create a new worksheet using WorkBook.CreateWorkSheet.

  4. Add values to individual cells using workSheet["cell name"].Value using var.

  5. Save the spreadsheet as a CSV file using the SaveAs method.

IronXL

IronXL emerges as a beacon of efficiency for C# developers seeking a seamless and powerful solution for writing data to CSV files as compared to the CSVHelper NuGet package. In the dynamic landscape of software development, the ability to handle and manipulate data is paramount, and IronXL steps up to the plate with its robust set of tools tailored for C#.

This article delves into the features and methodologies that make IronXL the go-to choice for C# developers looking to enhance the process of writing data to CSV files, striking the perfect balance between simplicity and precision.

Create a New Visual Studio Project

To begin using the IronXL library, the initial step involves either creating a fresh Visual Studio C# project or loading an existing one. Here are the instructions for generating a new project in Visual Studio:

  1. Open Visual Studio and navigate to the "File" menu. A drop-down menu will be displayed; within this menu, select "New". This action will reveal another side menu.

    How to Write A CSV File in C#, Figure 1: File Menu File Menu

  2. In the side menu, locate and click on "Project". This will open a new window. Within this window, utilize the search bar to find "Console Application". Choose the option associated with C# and proceed by clicking the Next button.

    How to Write A CSV File in C#, Figure 2: New Project- Console Application New Project- Console Application

  3. A configuration window will appear next. Enter the project name, specify the project location, and click on the Next button.

    How to Write A CSV File in C#, Figure 3: Configure Project Configure Project

  4. The final window will emerge. Here, pick the target framework and initiate the project creation process by clicking on the Create button.

    How to Write A CSV File in C#, Figure 4: Target Framework Target Framework

Installing CSV Library IronXL

Now that you've set up the project, it's time to incorporate the IronXL C# library. Follow these steps to install IronXL in your project:

  1. In Visual Studio, navigate to the Tools menu. A dropdown menu will emerge—select the NuGet Package Manager from this menu.
  2. Within the NuGet Package Manager, choose the Manage NuGet Packages for Solutions from the side menu that unfolds.

    How to Write A CSV File in C#, Figure 5: NuGet Packages NuGet Packages

  3. A new window will pop up. Head to the browser tab within this window, and in the search bar, type "IronXL". You'll see a list of IronXL packages; opt for the latest one and proceed to click on the Install button.

    How to Write A CSV File in C#, Figure 6: IronXL IronXL

Writing CSV Files Using IronXL

Write data into a CSV file using the C# CSV library IronXL. In this section, we will create a new CSV file and write data in it. The following example uses the IronXL library to create a simple receipt in a CSV file. Let's break down the program code step by step.

Importing IronXL and System.Linq

using IronXL; 
using System.Linq;

// This is the main class where execution starts.
public class Program {
    static void Main() {
        // Main method where all logic is executed
    }
}
using IronXL; 
using System.Linq;

// This is the main class where execution starts.
public class Program {
    static void Main() {
        // Main method where all logic is executed
    }
}
Imports IronXL
Imports System.Linq

' This is the main class where execution starts.
Public Class Program
	Shared Sub Main()
		' Main method where all logic is executed
	End Sub
End Class
$vbLabelText   $csharpLabel

These lines import the necessary classes and functionalities from the IronXL library for working with Excel files and the LINQ extension methods from the System.Linq namespace.

Creating a WorkBook and WorkSheet

// Create a new workbook. This serves as the container for all worksheets.
WorkBook workBook = WorkBook.Create();

// Create a new worksheet within the workbook named "Receipt".
WorkSheet workSheet = workBook.CreateWorkSheet("Receipt");
// Create a new workbook. This serves as the container for all worksheets.
WorkBook workBook = WorkBook.Create();

// Create a new worksheet within the workbook named "Receipt".
WorkSheet workSheet = workBook.CreateWorkSheet("Receipt");
' Create a new workbook. This serves as the container for all worksheets.
Dim workBook As WorkBook = WorkBook.Create()

' Create a new worksheet within the workbook named "Receipt".
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("Receipt")
$vbLabelText   $csharpLabel

This code creates a new Excel workbook (WorkBook) and a worksheet (WorkSheet) within that workbook named "Receipt".

Adding Headers

// Set the header row for columns. Headers added for better understanding of data.
workSheet["A1"].Value = "Product"; 
workSheet["B1"].Value = "Price";
// Set the header row for columns. Headers added for better understanding of data.
workSheet["A1"].Value = "Product"; 
workSheet["B1"].Value = "Price";
' Set the header row for columns. Headers added for better understanding of data.
workSheet("A1").Value = "Product"
workSheet("B1").Value = "Price"
$vbLabelText   $csharpLabel

These lines set the header row for the columns in the first row of the worksheet, labeling each column.

Populating Item Information

// Populate worksheet with product data and their respective prices.
workSheet["A2"].Value = "Item 1"; 
workSheet["B2"].DoubleValue = 20.10; 

workSheet["A3"].Value = "Item 2"; 
workSheet["B3"].DoubleValue = 15.50; 

workSheet["A4"].Value = "Item 3"; 
workSheet["B4"].DoubleValue = 10.25;
// Populate worksheet with product data and their respective prices.
workSheet["A2"].Value = "Item 1"; 
workSheet["B2"].DoubleValue = 20.10; 

workSheet["A3"].Value = "Item 2"; 
workSheet["B3"].DoubleValue = 15.50; 

workSheet["A4"].Value = "Item 3"; 
workSheet["B4"].DoubleValue = 10.25;
' Populate worksheet with product data and their respective prices.
workSheet("A2").Value = "Item 1"
workSheet("B2").DoubleValue = 20.10

workSheet("A3").Value = "Item 2"
workSheet("B3").DoubleValue = 15.50

workSheet("A4").Value = "Item 3"
workSheet("B4").DoubleValue = 10.25
$vbLabelText   $csharpLabel

These lines add information about three items, including their names and prices in the worksheet.

Calculating Total Price

// Define the range for price values to be summed.
var range = workSheet["B2:B4"];

// Calculate the sum of prices.
decimal sum = range.Sum();
// Define the range for price values to be summed.
var range = workSheet["B2:B4"];

// Calculate the sum of prices.
decimal sum = range.Sum();
' Define the range for price values to be summed.
Dim range = workSheet("B2:B4")

' Calculate the sum of prices.
Dim sum As Decimal = range.Sum()
$vbLabelText   $csharpLabel

Using LINQ, this code calculates the sum of the prices from cells B2 to B4. The sum is stored in the sum variable.

Displaying and Updating Total in the WorkSheet

// Display the sum in the console.
System.Console.WriteLine(sum);

// Update the total price in the worksheet.
workSheet["B5"].Value = sum;
// Display the sum in the console.
System.Console.WriteLine(sum);

// Update the total price in the worksheet.
workSheet["B5"].Value = sum;
' Display the sum in the console.
System.Console.WriteLine(sum)

' Update the total price in the worksheet.
workSheet("B5").Value = sum
$vbLabelText   $csharpLabel

The sum is printed to the console, and it is also updated in cell B5 of the worksheet.

Saving the Workbook as a CSV File

// Save the workbook as a CSV file named "receipt.csv".
workBook.SaveAs("receipt.csv");
// Save the workbook as a CSV file named "receipt.csv".
workBook.SaveAs("receipt.csv");
' Save the workbook as a CSV file named "receipt.csv".
workBook.SaveAs("receipt.csv")
$vbLabelText   $csharpLabel

Finally, the entire workbook is saved as a CSV file named "receipt.csv".

In summary, this code creates a basic receipt in an Excel worksheet using IronXL, calculates the total price, prints it to the console, and then saves the workbook output as a CSV file. The receipt includes columns for "Product" and "Price", and it calculates the total price based on the individual item prices.

How to Write A CSV File in C#, Figure 7: Receipt CSV File Output with Header Receipt CSV File Output with Header

Conclusion

This comprehensive article underscores the significance of writing CSV files in C# and elucidates the process using the IronXL library. It emphasizes the fundamental nature of this skill in diverse data-centric applications and showcases IronXL's prowess in simplifying and optimizing data manipulation tasks within the C# ecosystem. The step-by-step approach, from project setup to utilizing IronXL to create a receipt and save it as a CSV file, provides developers with a practical understanding of the seamless integration between C#.

By offering versatility and efficiency, IronXL emerges as a valuable tool for C# developers seeking to enhance their program and ability to handle and export data in the ubiquitous CSV format, making it a crucial asset for various software development scenarios.

IronXL provides a solution for all Excel-related tasks to be done programmatically whether it be formula calculation, string sorting, trimming, finding and replacing, merging and unmerging, saving files etc. You can also set cell data formats.

For the complete tutorial on writing into a CSV file, visit this blog here. The code example for creating a CSV file can be found in the following blog.

IronXL offers a free trial, allowing you to evaluate its capabilities. If you find it useful for your projects, you can purchase a license starting from $799.

Preguntas Frecuentes

¿Cómo puedo escribir archivos CSV en C# sin usar Interop?

Puedes utilizar la biblioteca IronXL para escribir archivos CSV en C# sin necesidad de Interop. IronXL te permite crear libros de trabajo y hojas de trabajo, agregar datos y guardarlos directamente como archivos CSV usando sus métodos integrados.

¿Qué ventajas tiene IronXL sobre CSVHelper para escribir archivos CSV?

IronXL ofrece una gama más extensa de características más allá de solo escribir CSV, como cálculos de fórmulas, formato de celdas y exportación en varios formatos de Excel, proporcionando una solución más completa para los desarrolladores.

¿Cómo puedo comenzar a usar IronXL en un proyecto C#?

Para comenzar a usar IronXL, necesitas instalarlo a través del Administrador de Paquetes NuGet en Visual Studio. Crea un nuevo proyecto C#, navega a 'Herramientas', selecciona 'Administrador de Paquetes NuGet', busca 'IronXL' e instálalo.

¿Se puede usar IronXL para manipular archivos de Excel además de escribir CSVs?

Sí, IronXL es capaz de manejar una amplia gama de tareas relacionadas con Excel, como leer y escribir archivos de Excel, realizar cálculos de fórmulas y gestionar datos en múltiples hojas de trabajo.

¿Cómo puedo agregar datos a una hoja de trabajo en C# usando IronXL?

Para agregar datos a una hoja de trabajo usando IronXL, accede a celdas individuales usando sus identificadores y asigna valores usando la propiedad Value. Luego puedes guardar la hoja de trabajo en el formato deseado.

¿Cómo guardo un libro de trabajo como un archivo CSV usando IronXL?

Después de crear y llenar tu libro de trabajo y hoja de trabajo en IronXL, puedes guardarlo como un archivo CSV usando el método SaveAs, especificando la ruta y el formato del archivo.

¿Hay una versión de prueba de IronXL disponible para evaluación?

Sí, IronXL ofrece una versión de prueba gratuita, que permite a los desarrolladores explorar y evaluar sus características antes de comprometerse a una compra.

¿Cómo puedo calcular el total de números en una hoja de trabajo usando IronXL?

Puedes calcular el total de números en una hoja de trabajo con IronXL usando LINQ para sumar un rango definido de celdas, aprovechando la compatibilidad de la biblioteca con expresiones LINQ de C#.

¿Cuáles son algunos problemas comunes al escribir archivos CSV en C# usando IronXL?

Los problemas comunes pueden incluir rutas de archivo incorrectas o permisos, desajustes en el formato de los datos o campos de datos faltantes. Un manejo adecuado de errores y la validación pueden ayudar a mitigar estos problemas.

¿Puede IronXL manejar grandes conjuntos de datos de manera eficiente en proyectos C#?

Sí, IronXL está diseñado para manejar grandes conjuntos de datos de manera eficiente, permitiendo a los desarrolladores leer, escribir y manipular archivos Excel extensos sin un retraso significativo en el rendimiento.

Jordi Bardia
Ingeniero de Software
Jordi es más competente en Python, C# y C++. Cuando no está aprovechando sus habilidades en Iron Software, está programando juegos. Compartiendo responsabilidades para pruebas de productos, desarrollo de productos e investigación, Jordi agrega un valor inmenso a la mejora continua del producto. La experiencia variada lo mantiene ...
Leer más