C# para .NET XLSX, ODS e CSV Sem precisar de Office

A biblioteca Excel para C# para arquivos XLSX

O sgcDocs é uma biblioteca Excel para C# que cria e lê arquivos XLSX com fórmulas, estilos e formatos numéricos, sem Office instalado, no Windows, Linux e macOS.

320 funções do Excel calculadas Fontes, preenchimentos, bordas, formatos numéricos ASP.NET Core, serviços, Linux DOCX e PDF na mesma API

Incluído no sgcUI .NET Enterprise. Ver preços →

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");
}

Como criar um arquivo Excel em C#

Para criar um arquivo Excel em C# sem o Excel, crie um TsgcDocsSpreadsheet, chame New, grave valores e fórmulas por endereço de célula, formate as células e chame SaveToFile. O formato vem da extensão do arquivo, então a mesma pasta de trabalho também é salva como ODS ou 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");
        }
    }
}

O arquivo mantém as fórmulas e os valores calculados. Text retorna uma célula como ela é impressa, com o formato numérico aplicado. A classe C# mantém os nomes da edição Delphi: uma propriedade indexada como Values['A1'] vira o par de métodos Values e SetValues, e o mesmo vale para Formulas, ColumnWidths e RowHeights.

Leia e atualize um arquivo XLSX em C#

LoadFromFile e LoadFromStream carregam XLSX, ODS e CSV com valores, fórmulas, estilos, células mescladas, layout, configuração de página, proteção, gráficos e os formatos condicionais dos arquivos XLSX. Altere o que precisar, calcule de novo e salve.

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 retorna um object: null para uma célula vazia, um DateTime para uma data e o texto do erro, como #DIV/0!, para um erro. Evaluate executa qualquer fórmula na pasta de trabalho sem gravá-la em uma célula.

Fórmulas, estilos e dados nos seus arquivos XLSX

O engine de pastas de trabalho por trás de TsgcDocsSpreadsheet é código C# gerenciado. Ele não precisa de Excel, de interoperabilidade COM nem de biblioteca nativa na máquina que o executa.

320 funções do Excel

Um texto que começa com = é uma fórmula. O engine calcula 320 funções do Excel, incluindo LET, LAMBDA e funções LAMBDA nomeadas, e DefineName adiciona nomes à pasta de trabalho, como VAT ou uma LAMBDA reutilizável.

Estilos e formatos numéricos

SetFormat define o tamanho da fonte, negrito, itálico, cores, preenchimento, alinhamento, quebra de texto, formato numérico, bordas, recuo e rotação de um intervalo. MergeCells mescla um intervalo.

Layout e planilhas

Larguras de coluna e alturas de linha, AddSheet, RenameSheet, que reescreve as fórmulas que se referem à planilha, DeleteSheet, e proteção de planilha e de pasta de trabalho.

Dados do seu banco de dados

ImportDataSet copia um DataTable ou um IDataReader para uma planilha, com os títulos das colunas ou os nomes dos campos como linha de cabeçalho, e retorna o número de linhas.

Gráficos preservados

Formatos, células mescladas, gráficos e formatos condicionais são preservados quando um arquivo XLSX é carregado e salvo de novo, e os gráficos de uma planilha são impressos junto com ela.

Saída em PDF, HTML e PNG

ExportToPDFFile imprime uma planilha ou todas as planilhas visíveis com a configuração de página da pasta de trabalho, ExportToHTML grava uma tabela HTML por planilha, e ExportSheetPageToPNG renderiza uma página impressa.

Arquivos Excel no ASP.NET Core e no Linux

O pacote roda em programas de console, serviços, ASP.NET Core e aplicativos desktop no Windows, Linux e macOS. SaveToStream grava a pasta de trabalho em qualquer stream, então uma API web retorna um arquivo XLSX sem arquivo temporário.

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();

Os componentes não são thread-safe: crie os que uma requisição precisa na thread que a atende, e instâncias separadas rodam em paralelo. No Linux e em contêineres, instale as fontes TrueType que os seus documentos usam, ou adicione uma pasta de fontes com AddFontFolder. As demonstrações .NET incluem o ConversionServer, uma minimal API do ASP.NET Core que converte documentos em um servidor.

Também uma biblioteca DOCX para C#: arquivos Word e PDF

O mesmo pacote cria e lê documentos do Word. TsgcDocsWordProcessor lê e grava DOCX, RTF, HTML, Markdown e texto, executa mala direta a partir de um DataTable, CSV ou JSON, e exporta para PDF. TsgcDocsConverter converte entre documentos, planilhas, arquivos PDF e imagens em uma única chamada.

// 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 do Word

Preencha um modelo DOCX feito no Word com ReplaceAll, ou una-o aos seus dados, e salve o resultado como DOCX ou PDF.

Processamento de PDF

TsgcDocsPDFProcessor une, divide e gira páginas, extrai texto, preenche formulários, criptografa com AES-256, converte para PDF/A e assina.

Códigos de barras e ZIP

TsgcDocsBarcode grava QR Code, Data Matrix, Code 128 e mais em PNG, SVG ou em uma página PDF, e TsgcDocsZipArchive cria arquivos ZIP64.

Instale a biblioteca Excel para C# pelo NuGet

Adicione o pacote esegece.sgcDocs ao projeto. O NuGet adiciona os engines em que ele se baseia: esegece.sgcUICore, esegece.sgcPDF, esegece.sgcRichEdit, esegece.sgcGrid, esegece.sgcSpreadsheet e esegece.sgcCharts.

dotnet add package esegece.sgcDocs

esegece.sgcDocs é um pacote Registered, incluído no sgcUI .NET Enterprise e no All-Access, e não é publicado no nuget.org. Páginas PNG e SVG de documentos e planilhas precisam de mais um pacote, esegece.sgcUICore.Rendering, de modo que servidores que só gravam arquivos XLSX, DOCX e PDF não carreguem bibliotecas nativas de renderização.

PacoteFrameworks de destinoRoda em
esegece.sgcDocs.NET Standard 2.0, .NET Framework 4.7.2, .NET 6, 8, 9 e 10Windows, Linux e macOS, em programas de console, serviços, ASP.NET Core e aplicativos desktop
esegece.sgcUICore.RenderingAdicionado somente quando necessárioPáginas PNG e SVG de documentos e planilhas

Onde a biblioteca Excel para C# está incluída

O sgcDocs não é vendido isoladamente e não tem edição Community gratuita. O sgcUI .NET Enterprise inclui o código-fonte C# completo e 1 ano de atualizações.

sgcUI .NET Enterprise

Todos os produtos sgcUI para .NET, sgcDocs incluído, com o código-fonte C# completo para WinForms, WPF e Avalonia, a partir de €699 por desenvolvedor.

All-Access

Todos os produtos da eSeGeCe, sgcUI Enterprise e sgcDocs incluídos.

Ver All-Access →

Também para Delphi e C++ Builder

A mesma API com os mesmos nomes de classe para Delphi 7 a 13 e C++ Builder 2007 a 13, no Win32, Win64 e Linux64.

sgcDocs para Delphi →

Perguntas frequentes

Adicione o pacote esegece.sgcDocs, crie um TsgcDocsSpreadsheet, chame New, grave as células com SetValues e SetFormulas e chame SaveToFile("report.xlsx"). A pasta de trabalho é gravada por código C# gerenciado, então nem o Excel nem o Office precisam estar instalados na máquina.

Sim. Um texto que começa com = é uma fórmula, e o engine calcula 320 funções do Excel antes de o arquivo ser salvo, então o XLSX contém tanto as fórmulas quanto os seus valores. SetFormat define fontes, cores, preenchimentos, alinhamento, quebra de texto, bordas e formatos numéricos em um intervalo, e SetColumnWidths e SetRowHeights dimensionam o layout.

Sim, arquivos XLSX, ODS e CSV. LoadFromFile ou LoadFromStream carrega os valores, fórmulas, estilos, células mescladas, configuração de página, proteção e gráficos, e Values, Formulas e Text leem qualquer célula. O formato binário XLS não é suportado.

Sim. O pacote tem como destino .NET Standard 2.0, .NET Framework 4.7.2 e .NET 6 a 10, e roda em programas de console, serviços, ASP.NET Core e aplicativos desktop no Windows, Linux e macOS. Crie um componente por requisição, porque os componentes não são thread-safe, e instale no servidor as fontes TrueType que os seus documentos usam.

Sim. TsgcDocsWordProcessor, no mesmo pacote, cria, lê e edita documentos DOCX, RTF, HTML e Markdown, preenche modelos, executa mala direta e exporta para PDF. TsgcDocsPDFProcessor une, criptografa, converte para PDF/A e assina arquivos PDF.

Não. O sgcDocs não tem edição Community gratuita. O pacote .NET é somente Registered, está incluído no sgcUI .NET Enterprise e no All-Access, e não é publicado no nuget.org. Para uma avaliação .NET, fale conosco.

Sim. A licença do sgcUI .NET Enterprise inclui o código-fonte C# completo e 1 ano de atualizações. Veja a página de preços do sgcUI.

Melhor custo-benefício: All-AccessTodos os produtos da eSeGeCe, com Suporte Premium incluído, a partir de €1,059/ano.
Ver preços do All-Access

Crie arquivos Excel a partir do seu código C#

XLSX, DOCX e PDF a partir de um único pacote .NET, sem Office na máquina.