C# para .NET XLSX, ODS y CSV Sin necesidad de Office

La biblioteca Excel para C# para archivos XLSX

sgcDocs es una biblioteca Excel para C# que crea y lee archivos XLSX con fórmulas, estilos y formatos numéricos, sin Office instalado, en Windows, Linux y macOS.

320 funciones de Excel calculadas Fuentes, rellenos, bordes, formatos numéricos ASP.NET Core, servicios, Linux DOCX y PDF en la misma API

Incluido en sgcUI .NET Enterprise. Ver precios →

using esegece.sgcDocs;

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.New();
    sheet.SetValues("A1", "Units");
    sheet.SetValues("A2", 12);
    sheet.SetValues("A3", 30);
    sheet.SetFormulas("A4", "=SUM(A2:A3)");
    sheet.Calculate();
    sheet.SaveToFile("units.xlsx");
    sheet.ExportToPDFFile("units.pdf");
}

Cómo crear un archivo de Excel en C#

Para crear un archivo de Excel en C# sin Excel, crea un TsgcDocsSpreadsheet, llama a New, escribe valores y fórmulas por dirección de celda, da formato a las celdas y llama a SaveToFile. El formato sale de la extensión del archivo, así que el mismo libro también se guarda como ODS o CSV.

using System;
using esegece.sgcDocs;
using esegece.sgcGrid;

static class SalesReport
{
    public static void Create()
    {
        using (var sheet = new TsgcDocsSpreadsheet())
        {
            sheet.New();
            sheet.RenameSheet(0, "Sales");

            // a header row and three data rows, from one and two dimensional arrays
            sheet.SetRange("A1", new object[] { "Product", "Units", "Price", "Total" });
            sheet.SetRange("A2", new object[,]
            {
                { "Paper", 12, 4.5 },
                { "Toner", 3, 39.9 },
                { "Labels", 20, 2.75 }
            });

            // formulas, calculated by the engine and saved with the file
            sheet.SetFormulas("D2", "=B2*C2");
            sheet.SetFormulas("D3", "=B3*C3");
            sheet.SetFormulas("D4", "=B4*C4");
            sheet.SetValues("A5", "Total");
            sheet.SetFormulas("D5", "=SUM(D2:D4)");

            // a bold, centred header with a fill colour (ARGB)
            TsgcGridCellFormat header = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            header.Bold = true;
            header.Alignment = TsgcGridAlignment.gaCenter;
            header.FillColor = 0xFFDDEBF7;
            sheet.SetFormat("A1:D1", header);

            // a number format for the money columns
            TsgcGridCellFormat money = sgcGrid_CellFormat.sgcGridCellFormatEmpty();
            money.NumberFormat = "#,##0.00";
            sheet.SetFormat("C2:D5", money);

            // column widths in DIPs
            sheet.SetColumnWidths("A", 140);
            sheet.SetColumnWidths("D", 90);

            sheet.Calculate();
            Console.WriteLine("Total: " + sheet.Text("D5"));
            sheet.SaveToFile("sales.xlsx");
        }
    }
}

El archivo conserva las fórmulas y sus valores calculados. Text devuelve una celda tal como se imprime, con su formato numérico aplicado. La clase de C# mantiene los nombres de la edición para Delphi: una propiedad indexada como Values['A1'] pasa a ser el par de métodos Values y SetValues, y lo mismo ocurre con Formulas, ColumnWidths y RowHeights.

Lee y actualiza un archivo XLSX en C#

LoadFromFile y LoadFromStream cargan XLSX, ODS y CSV con valores, fórmulas, estilos, celdas combinadas, diseño, configuración de página, protección, gráficos y los formatos condicionales de los archivos XLSX. Cambia lo que necesites, vuelve a calcular y guarda.

using (var sheet = new TsgcDocsSpreadsheet())
{
    sheet.LoadFromFile("sales.xlsx");
    Console.WriteLine(sheet.SheetNames(0) + ": " + sheet.UsedRange());
    Console.WriteLine("D2 formula: " + sheet.Formulas("D2"));
    Console.WriteLine("Units of B3: " + sheet.Values("B3"));

    // change a value, calculate again, save and print to PDF
    sheet.SetValues("B3", 5);
    sheet.Calculate();
    Console.WriteLine("New total: " + sheet.Text("D5"));
    sheet.SaveToFile("sales_updated.xlsx");
    Console.WriteLine(sheet.ExportToPDFFile("sales.pdf") + " PDF page(s)");
}

Values devuelve un object: null para una celda vacía, un DateTime para una fecha y el texto del error, como #DIV/0!, para un error. Evaluate ejecuta cualquier fórmula sobre el libro sin escribirla en una celda.

Fórmulas, estilos y datos en tus archivos XLSX

El motor de libros que hay detrás de TsgcDocsSpreadsheet es código C# administrado. No necesita Excel, ni interoperabilidad COM, ni bibliotecas nativas en la máquina que lo ejecuta.

320 funciones de Excel

Un texto que empieza por = es una fórmula. El motor calcula 320 funciones de Excel, incluidas LET, LAMBDA y funciones LAMBDA con nombre, y DefineName añade nombres de libro como VAT o una LAMBDA reutilizable.

Estilos y formatos numéricos

SetFormat establece el tamaño de fuente, negrita, cursiva, colores, relleno, alineación, ajuste de texto, formato numérico, bordes, sangría y rotación de un rango. MergeCells combina un rango.

Diseño y hojas

Anchos de columna y alturas de fila, AddSheet, RenameSheet, que reescribe las fórmulas que hacen referencia a la hoja, DeleteSheet, y protección de hojas y de libro.

Datos de tu base de datos

ImportDataSet copia un DataTable o un IDataReader en una hoja, con los títulos de columna o los nombres de campo como fila de cabecera, y devuelve el número de filas.

Gráficos conservados

Los formatos, las celdas combinadas, los gráficos y los formatos condicionales se conservan cuando se carga y se vuelve a guardar un archivo XLSX, y los gráficos de una hoja se imprimen con ella.

Salida a PDF, HTML y PNG

ExportToPDFFile imprime una hoja o todas las hojas visibles con la configuración de página del libro, ExportToHTML escribe una tabla HTML por hoja, y ExportSheetPageToPNG renderiza una página impresa.

Archivos de Excel en ASP.NET Core y en Linux

El paquete se ejecuta en programas de consola, servicios, ASP.NET Core y aplicaciones de escritorio en Windows, Linux y macOS. SaveToStream escribe el libro en cualquier flujo, de modo que una API web devuelve un archivo XLSX sin archivo temporal.

using esegece.sgcDocs;

var app = WebApplication.CreateBuilder(args).Build();

// GET /report.xlsx returns a workbook built for the request
app.MapGet("/report.xlsx", () =>
{
    var stream = new MemoryStream();
    using (var sheet = new TsgcDocsSpreadsheet())
    {
        sheet.New();
        sheet.SetValues("A1", "Generated");
        sheet.SetValues("B1", DateTime.Now);
        sheet.SaveToStream(stream, TsgcDocsFormat.dfXLSX);
    }
    stream.Position = 0;
    return Results.File(stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "report.xlsx");
});

app.Run();

Los componentes no son seguros para hilos: crea los que necesite una petición en el hilo que la atiende, y las instancias separadas se ejecutan en paralelo. En Linux y en contenedores, instala las fuentes TrueType que usen tus documentos, o añade una carpeta de fuentes con AddFontFolder. Las demos .NET incluyen ConversionServer, una API mínima de ASP.NET Core que convierte documentos en un servidor.

También una biblioteca DOCX para C#: archivos Word y PDF

El mismo paquete crea y lee documentos de Word. TsgcDocsWordProcessor lee y escribe DOCX, RTF, HTML, Markdown y texto, ejecuta combinaciones de correspondencia desde un DataTable, CSV o JSON, y exporta a PDF. TsgcDocsConverter convierte entre documentos, hojas de cálculo, archivos PDF e imágenes en una sola llamada.

// a Word document saved as DOCX and PDF
using (var word = new TsgcDocsWordProcessor())
{
    word.New();
    word.Title = "Quarterly report";
    word.AppendParagraph("Quarterly report", "Heading 1");
    word.AppendParagraph("Sales grew 12% in the third quarter.");
    word.SaveToFile("report.docx");
    word.ExportToPDFFile("report.pdf");
    Console.WriteLine("Pages: " + word.PageCount);
}

// one call conversions, the formats come from the file extensions
using (var converter = new TsgcDocsConverter())
{
    converter.Convert("sales.xlsx", "sales.csv");
    converter.Convert("report.docx", "report.html");
}

Documentos de Word

Rellena una plantilla DOCX hecha en Word con ReplaceAll, o combínala con tus datos, y guarda el resultado como DOCX o PDF.

Procesamiento de PDF

TsgcDocsPDFProcessor combina, divide y rota páginas, extrae texto, rellena formularios, cifra con AES-256, convierte a PDF/A y firma.

Códigos de barras y ZIP

TsgcDocsBarcode escribe QR Code, Data Matrix, Code 128 y más como PNG, SVG o en una página PDF, y TsgcDocsZipArchive crea archivos ZIP64.

Instala la biblioteca Excel para C# desde NuGet

Añade el paquete esegece.sgcDocs al proyecto. NuGet añade los motores en los que se apoya: esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet y esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs es un paquete Registered, incluido en sgcUI .NET Enterprise y All-Access, y no se publica en nuget.org. Las páginas PNG y SVG de documentos y hojas necesitan un paquete más, esegece.sgcUICore.Rendering, de modo que los servidores que solo escriben archivos XLSX, DOCX y PDF no cargan bibliotecas de renderizado nativas.

PaqueteFrameworks de destinoSe ejecuta en
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 y 10Windows, Linux y macOS, en programas de consola, servicios, ASP.NET Core y aplicaciones de escritorio
esegece.sgcUICore.RenderingSe añade solo cuando hace faltaPáginas PNG y SVG de documentos y hojas

Dónde se incluye la biblioteca Excel para C#

sgcDocs no se vende por separado y no tiene edición Community gratuita. sgcUI .NET Enterprise incluye el código fuente completo en C# y 1 año de actualizaciones.

sgcUI .NET Enterprise

Todos los productos sgcUI para .NET, sgcDocs incluido, con código fuente completo en C# para WinForms, WPF y Avalonia, desde €699 por desarrollador.

All-Access

Todos los productos de eSeGeCe, sgcUI Enterprise y sgcDocs incluidos.

Ver All-Access →

También para Delphi y C++ Builder

La misma API con los mismos nombres de clase para Delphi 7 a 13 y C++ Builder 2007 a 13, en Win32, Win64 y Linux64.

sgcDocs para Delphi →

Preguntas frecuentes

Añade el paquete esegece.sgcDocs, crea un TsgcDocsSpreadsheet, llama a New, escribe celdas con SetValues y SetFormulas, y llama a SaveToFile("report.xlsx"). El libro lo escribe código C# administrado, así que no hace falta tener instalado Excel ni Office en la máquina.

Sí. Un texto que empieza por = es una fórmula, y el motor calcula 320 funciones de Excel antes de guardar el archivo, de modo que el XLSX contiene tanto las fórmulas como sus valores. SetFormat establece fuentes, colores, rellenos, alineación, ajuste de texto, bordes y formatos numéricos en un rango, y SetColumnWidths y SetRowHeights dimensionan el diseño.

Sí, archivos XLSX, ODS y CSV. LoadFromFile o LoadFromStream carga los valores, fórmulas, estilos, celdas combinadas, configuración de página, protección y gráficos, y Values, Formulas y Text leen cualquier celda. El formato binario XLS no es compatible.

Sí. El paquete apunta a .NET Standard 2.0, .NET Framework 4.7.2 y .NET 6 a 10, y se ejecuta en programas de consola, servicios, ASP.NET Core y aplicaciones de escritorio en Windows, Linux y macOS. Crea un componente por petición, porque los componentes no son seguros para hilos, e instala en el servidor las fuentes TrueType que usen tus documentos.

Sí. TsgcDocsWordProcessor del mismo paquete crea, lee y edita documentos DOCX, RTF, HTML y Markdown, rellena plantillas, ejecuta combinaciones de correspondencia y exporta a PDF. TsgcDocsPDFProcessor combina, cifra, convierte a PDF/A y firma archivos PDF.

No. sgcDocs no tiene edición Community gratuita. El paquete .NET es solo Registered, está incluido en sgcUI .NET Enterprise y All-Access, y no se publica en nuget.org. Para una evaluación de .NET, contáctanos.

Sí. La licencia de sgcUI .NET Enterprise incluye el código fuente completo en C# y 1 año de actualizaciones. Consulta la página de precios de sgcUI.

La mejor opción: All-AccessTodos los productos de eSeGeCe, con Premium Support incluido, desde €1,059 al año.
Ver precios de All-Access

Crea archivos de Excel desde tu código C#

XLSX, DOCX y PDF desde un solo paquete .NET, sin Office en la máquina.