Como criar novas planilhas em C#

Como criar novas planilhas em C

This article was translated from English: Does it need improvement?
Translated
View the article in English

Criar novas planilhas no C# é simples com o método WorkBook.Create() do IronXL, que gera arquivos XLSX ou XLS em uma única linha. Esta abordagem elimina dependências complexas de interop de Excel e funciona perfeitamente em aplicações .NET.

Início Rápido: Crie um novo livro XLSX com IronXL

Use a API de uma única linha do IronXL para gerar um novo workbook no formato XLSX—sem necessidade de configuração complexa. Essa abordagem permite que você construa planilhas em C# de forma rápida e eficiente.

  1. Instale IronXL com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronXL.Excel
  2. Copie e execute este trecho de código.

    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
  3. Implante para testar em seu ambiente de produção.

    Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita

    arrow pointer


Como criar uma planilha básica em C#?

Use o método estático Create para criar um workbook do Excel que pode armazenar uma coleção de folhas ou planilhas. Por padrão, este método cria um workbook do Excel no formato XLSX. A Referência de API do IronXL fornece documentação abrangente sobre todos os métodos e propriedades disponíveis.

:path=/static-assets/excel/content-code-examples/how-to/create-spreadsheet-create-spreadsheet.cs
using IronXL;

// Create spreadsheet
WorkBook workBook = WorkBook.Create();
Imports IronXL

' Create spreadsheet
Private workBook As WorkBook = WorkBook.Create()
$vbLabelText   $csharpLabel

O que acontece quando eu chamo WorkBook.Create()?

Quando você chama WorkBook.Create(), IronXL inicializa um novo objeto workbook na memória com as configurações padrão. O livro inicialmente não contém planilhas—você deve adicionar pelo menos uma planilha antes de trabalhar com dados. Esse método cria uma estrutura de livro limpa pronta para suas necessidades de manipulação de dados.

XLSX é um formato de arquivo moderno para armazenar planilhas do Microsoft Excel. Ele usa o padrão Open XML, introduzido no Office 2007. XLSX suporta recursos avançados como gráficos e formatação condicional e é amplamente utilizado para análise de dados e tarefas empresariais. Para mais detalhes sobre o trabalho com recursos do Excel, confira nossa visão geral abrangente de recursos.

Por que o IronXL usa o formato padrão XLSX?

IronXL usa XLSX por padrão porque é o padrão da indústria atual, oferecendo melhor compressão, recuperação de dados aprimorada e suporte para recursos modernos do Excel. Arquivos XLSX são menores do que seus equivalentes XLS e suportam planilhas maiores (até 1.048.576 linhas por 16.384 colunas).

XLS é o formato binário mais antigo para arquivos do Excel usado em versões anteriores. Ele não possui os recursos de XLSX e agora é menos comum. No entanto, o IronXL suporta ambos os formatos para garantir compatibilidade com sistemas legados quando necessário.


Como posso escolher entre os formatos XLSX e XLS?

O método Create aceita um enum ExcelFileFormat que especifica se deve criar um arquivo XLSX ou XLS. Ambos os formatos de arquivo armazenam planilhas do Microsoft Excel, com XLSX sendo o formato moderno baseado em XML introduzido no Office 2007, enquanto XLS é o formato binário mais antigo usado em versões anteriores. XLS agora é menos comum devido a seus recursos limitados e menor eficiência em comparação com XLSX.

:path=/static-assets/excel/content-code-examples/how-to/create-spreadsheet-spreadsheet-type.cs
using IronXL;

// Create XLSX spreadsheet
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
Imports IronXL

' Create XLSX spreadsheet
Private workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
$vbLabelText   $csharpLabel

Quando devo usar XLS em vez de XLSX?

Use o formato XLS apenas quando:

  • Sua aplicação precisa suportar o Excel 2003 ou versões anteriores
  • Você estiver integrando com sistemas legados que requerem o formato XLS
  • Políticas corporativas exigem o uso de formatos de arquivo mais antigos

Para todos os outros cenários, XLSX é recomendado devido ao seu desempenho superior, tamanhos de arquivo menores e suporte para recursos modernos do Excel. Saiba mais sobre como exportar arquivos do Excel em vários formatos.

Quais opções de configuração estão disponíveis?

Outra sobrecarga para o método Create recebe CreatingOptions como parâmetro. Atualmente, a classe CreatingOptions tem apenas uma propriedade, DefaultFileFormat, que configura se deve criar um arquivo XLSX ou XLS. Consulte o código abaixo para referência:

:path=/static-assets/excel/content-code-examples/how-to/create-spreadsheet-creating-options.cs
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
' ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$vbLabelText   $csharpLabel

Como faço para exportar a planilha criada?

Depois de criar e preencher sua planilha, você tem várias opções de exportação. IronXL suporta salvar em vários formatos incluindo XLSX, XLS, CSV, TSV, JSON, XML, e HTML. Para orientação detalhada sobre como escrever valores Excel, veja nosso tutorial sobre como escrever arquivos Excel no .NET.

:path=/static-assets/excel/content-code-examples/how-to/create-spreadsheet-export-workbook.cs
using IronXL;

// Create a new workbook and add a worksheet
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("sheet1");

// Populate a cell with sample data
workSheet["A1"].StringValue = "Hello World";

// Export the workbook to XLSX format
workBook.SaveAs("createdSpreadsheet.xlsx");

// Export the workbook to CSV format
workBook.SaveAs("createdSpreadsheet.csv");

// Export the workbook to JSON format
workBook.SaveAs("createdSpreadsheet.json");

// Export the workbook as HTML
workBook.ExportToHtml("createdSpreadsheet.html");
Imports IronXL

' Create a new workbook and add a worksheet
Dim workBook As WorkBook = WorkBook.Create()
Dim workSheet As WorkSheet = workBook.CreateWorkSheet("sheet1")

' Populate a cell with sample data
workSheet("A1").StringValue = "Hello World"

' Export the workbook to XLSX format
workBook.SaveAs("createdSpreadsheet.xlsx")

' Export the workbook to CSV format
workBook.SaveAs("createdSpreadsheet.csv")

' Export the workbook to JSON format
workBook.SaveAs("createdSpreadsheet.json")

' Export the workbook as HTML
workBook.ExportToHtml("createdSpreadsheet.html")
$vbLabelText   $csharpLabel

Melhores Práticas para Criar Planilhas

Ao criar planilhas programaticamente com IronXL, considere estas melhores práticas:

  1. Gerenciamento de Memória: Sempre elimine objetos workbook ao finalizar, especialmente ao processar vários arquivos
  2. Tratamento de Erros: Implemente blocos try-catch para lidar com possíveis erros de sistema de arquivos ou formato
  3. Licenciamento: Certifique-se de ter configurado corretamente sua chave de licença para uso em produção
  4. Desempenho: Para grandes conjuntos de dados, considere escrever dados em partes em vez de operações célula por célula

Para cenários mais avançados, explore nosso tutorial detalhado sobre como criar arquivos Excel no .NET que abrange formatos complexos, fórmulas e opções de estilo.

Próximos passos

Agora que você sabe como criar planilhas, talvez você queira:

Comece com nosso guia abrangente de início rápido para explorar todas as capacidades de IronXL.Excel para automação de Excel em C#.

Perguntas frequentes

Como faço para criar uma nova planilha do Excel em C#?

Você pode criar uma nova planilha do Excel em C# usando o método `WorkBook.Create()` do IronXL. Essa API de linha única gera uma nova pasta de trabalho no formato XLSX por padrão, eliminando a necessidade de dependências complexas de interoperabilidade com o Excel. Basta chamar `WorkBook workBook = WorkBook.Create();` para começar.

O que acontece quando eu chamo WorkBook.Create()?

Ao chamar WorkBook.Create(), o IronXL inicializa um novo objeto de pasta de trabalho na memória com configurações padrão. Inicialmente, a pasta de trabalho não contém planilhas, portanto, você deve adicionar pelo menos uma planilha usando CreateWorkSheet() antes de trabalhar com os dados. Isso cria uma estrutura de pasta de trabalho limpa, pronta para a manipulação de dados.

Posso criar arquivos XLS em vez de XLSX?

Sim, você pode criar arquivos XLS especificando o parâmetro de formato no método Create do IronXL. Use WorkBook.Create(ExcelFileFormat.XLS) para criar uma pasta de trabalho no formato XLS (mais antigo) em vez do formato XLSX (padrão).

Por que a biblioteca usa o formato XLSX por padrão?

O IronXL usa o formato XLSX por padrão, pois é o padrão atual da indústria. O XLSX oferece melhor compressão, recuperação de dados aprimorada e suporte para recursos modernos do Excel. Esses arquivos são menores que os arquivos XLS e suportam planilhas maiores, com até 1.048.576 linhas por 16.384 colunas.

Como adiciono dados à minha planilha recém-criada?

Após criar uma pasta de trabalho com o IronXL, adicione uma planilha usando CreateWorkSheet() e defina os valores das células diretamente. Por exemplo: workSheet["A1"].Value = "Hello World"; Você pode atribuir vários tipos de dados, incluindo strings, números e objetos DateTime às células.

Posso usar CreatingOptions para configurar a criação da pasta de trabalho?

Sim, o IronXL fornece a classe CreatingOptions para configurar a criação de pastas de trabalho. Isso permite personalizar várias configurações ao gerar novas planilhas, oferecendo maior controle sobre a estrutura e as propriedades iniciais da pasta de trabalho.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Leia mais
Pronto para começar?
Nuget Downloads 2,134,203 | Versão: 2026.7 recém-lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXL.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.