Analizador CSV en C# (Tutorial paso a paso)

¿Debo usar el Administrador de paquetes NuGet de Visual Studio?

La IU del Administrador de Paquetes NuGet está disponible en Visual Studio para instalar el paquete directamente en el proyecto. Este método es particularmente útil para los desarrolladores que prefieren interfaces visuales y desean ver los detalles del paquete antes de la instalación. La captura de pantalla a continuación muestra cómo abrirlo.

Access the NuGet Package Manager in Visual Studio by navigating to Tools > NuGet Package Manager > Manage NuGet Packages for Solution

La interfaz del Administrador de paquetes proporciona una función de Examinar que muestra una lista de bibliotecas de paquetes disponibles en el sitio web de NuGet. Ingresa "IronXL" como se muestra en la captura de pantalla a continuación para encontrar el paquete IronXL. También puedes explorar funciones relacionadas con la manipulación de Excel que ofrece IronXL.

El Administrador de paquetes NuGet en Visual Studio mostrando la biblioteca IronXl.Excel, que permite a los desarrolladores leer, generar y editar archivos de Excel en aplicaciones .NET. El paquete se muestra con 250K descargas y la versión 2022.9.9454 lista para la instalación

Selecciona el paquete IronXl.Excel y haz clic en el botón Install para agregarlo al proyecto. El proceso de instalación manejará automáticamente todas las dependencias y configurará tu proyecto para la manipulación de archivos Excel.

¿Cuándo debo usar la línea de comandos de Visual Studio?

En el menú de Visual Studio, ve a Herramientas > Administrador de paquetes NuGet > haz clic en Consola del administrador de paquetes. Este método es preferido por los desarrolladores que están cómodos con interfaces de línea de comandos o necesitan automatizar el proceso de instalación en scripts de compilación.

Abriendo la Consola del Administrador de paquetes NuGet en Visual Studio para instalar bibliotecas de análisis CSV

La Consola del administrador de paquetes aparecerá en la parte inferior de la pantalla. Escribe el siguiente comando y presiona enter. IronXL se instalará. Este método es particularmente útil cuando necesitas instalar versiones específicas o cuando trabajas con scripts de implementación para Azure o entornos AWS.

Install-Package IronXL.Excel

La Consola del Administrador de paquetes muestra la instalación exitosa de la versión 2022.11.10251 de IronXl.Excel, mostrando el proceso de restauración del paquete y las confirmaciones de descarga desde el repositorio NuGet

¿Cómo convierto un archivo XLSX a CSV?

Abre Microsoft Excel y crea un nuevo archivo XLSX. Llena sus filas y columnas con algunos datos ficticios. Para escenarios de producción, podrías querer crear archivos Excel programáticamente usando IronXL. La imagen a continuación muestra el archivo utilizado para todas las conversiones en este tutorial.

Figura 6: Datos de Excel de Muestra mostrando una estructura básica de inventario que se utilizará para demostrar el análisis CSV en C#

Una vez que tengas tu archivo listo, escribe el siguiente código de ejemplo y ejecuta el programa. IronXL maneja todo el análisis complejo internamente, incluyendo el manejo adecuado de caracteres especiales y tipos de datos:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLSX file into a WorkBook object
        // The Load method automatically detects the file format
        WorkBook wb = WorkBook.Load("test.xlsx");

        // Save the WorkBook as a CSV file
        // This method handles all formatting and conversion automatically
        wb.SaveAsCsv("Parsed CSV.csv");

        // Optional: Save with custom delimiter
        // wb.SaveAsCsv("Parsed CSV.csv", delimiter: ";");
    }
}

Después de que la ejecución esté completa, se creará un nuevo archivo llamado Parsed CSV.csv. Puedes leer archivos CSV en cualquier editor o lector que prefieras. También puedes importar los datos CSV de vuelta a Excel para una mayor manipulación. La imagen a continuación muestra la salida del comando anterior: nuestros datos CSV generados. En el archivo de salida, las comillas dobles representan valores en negrita.

Figura 7: La salida CSV generada por el método SaveAsCsv, mostrando los datos de Excel convertidos en formato separado por comas

¿Cuáles son los pasos para convertir archivos XLS a CSV?

En este ejemplo, veremos cómo convertir archivos XLS en formato CSV. El proceso es idéntico a la conversión de XLSX, demostrando la versatilidad de IronXL en el manejo de diferentes formatos de archivo de Excel.

Primero, crearemos un ejemplo de archivo XLS que podamos convertir al formato CSV. Ten en cuenta que el XLS es un formato de Excel más antiguo, pero IronXL lo maneja sin problemas junto con formatos modernos:

Figura 8: Un archivo de Excel de muestra demostrando la estructura de datos del inventario con cálculos automáticos, que se puede analizar utilizando bibliotecas CSV en C#

A continuación, ejecutaremos el bloque de código a continuación para convertir el archivo XLS de muestra en un archivo CSV. IronXL preserva la integridad de los datos durante la conversión, incluidas las fórmulas y cálculos:

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the XLS file into a WorkBook object
        // IronXL automatically handles the older XLS format
        WorkBook wb = WorkBook.Load("XLS.xls");

        // Save the WorkBook as a CSV file
        // All formulas are evaluated and results are exported
        wb.SaveAsCsv("Example2.csv");

        // Optional: Export specific worksheet
        // WorkSheet ws = wb.GetWorkSheet("Sheet1");
        // ws.SaveAsCsv("Example2.csv");
    }
}

Después de que el código anterior termine de ejecutarse, tendrás un archivo CSV recién generado. Para escenarios más complejos, podrías querer seleccionar rangos específicos o ordenar los datos antes de exportar.

Archivo CSV de ejemplo abierto en WordPad mostrando datos formateados correctamente separados por comas con encabezados y múltiples entradas de productos

¿Cómo puedo analizar archivos CSV desde formato TSV?

Las aplicaciones de hoja de cálculo usan frecuentemente archivos TSV, o archivos de valores separados por tabulaciones, para transferir datos entre bases de datos. Guarda una tabla de datos con tabulaciones separando las columnas de datos y cada registro en una línea diferente. Los archivos TSV son particularmente útiles cuando tus datos contienen comas que podrían interferir con el análisis de CSV.

IronXL ofrece un analizador CSV para analizar archivos CSV desde el formato TSV para una mejor gestión de datos. El proceso de conversión es sencillo y mantiene la integridad de los datos.

Comencemos con el ejemplo. Primero, crearemos un archivo TSV con datos de estudiantes:

Ejemplo de datos de estudiantes separados por tabulaciones mostrados en Microsoft Word, mostrando la estructura de un archivo TSV con columnas para NOMBRE, CORREO, R-NO, y Calificación

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load the TSV file into a WorkBook object
        // IronXL automatically detects tab-separated format
        WorkBook wb = WorkBook.Load("TSV.tsv");

        // Save the WorkBook as a CSV file
        // Tabs are converted to commas automatically
        wb.SaveAsCsv("Example3.csv");

        // Alternative: Load with explicit delimiter specification
        // WorkBook wb = WorkBook.LoadCSV("TSV.tsv", delimiter: "\t");
    }
}

A continuación se muestra la salida en formato CSV. Observa cómo IronXL ha convertido correctamente los valores separados por tabulaciones en valores separados por comas mientras mantiene la estructura de los datos:

Ejemplo de archivo CSV abierto en WordPad mostrando registros de estudiantes con campos de nombre, correo, número de matrícula y calificación separados por comas