1. IronXL
  2. Tutoriais
  3. Criar planilhas
Como criar novas planilhas em C#

Como criar novas planilhas em C#

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

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

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

Use a API de uma linha do IronXL para gerar um novo workbook no formato XLSX—nenhuma configuração complexa é necessária. 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
### Fluxo de trabalho mínimo (5 etapas)
  1. Baixe a biblioteca C# para criar planilhas
  2. Use the static `Create` method to create a spreadsheet
  3. Choose whether to create an `XLSX` or `XLS` file
  4. Exporte a planilha e verifique o arquivo do Excel.
  5. Use the `CreatingOptions` class to configure the workbook creation


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 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();
$vbLabelText   $csharpLabel

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

Ao chamar WorkBook.Create(), o IronXL inicializa um novo objeto de workbook na memória com 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 usado 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?

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

XLS é o formato binário antigo para arquivos do Excel usado em versões anteriores. Ele não possui os recursos do 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 antigo utilizado em versões anteriores. XLS é agora menos comum devido aos 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);
$vbLabelText   $csharpLabel

Quando devo usar XLS em vez de XLSX?

Use o formato XLS somente quando:

  • Sua aplicação precisa suportar o Excel 2003 ou versões anteriores
  • Você estiver integrando 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 aceita CreatingOptions como parâmetro. Atualmente, a classe CreatingOptions possui 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!
$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. O IronXL suporta salvamento 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
// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!
$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 libere os objetos workbook quando terminar, especialmente ao processar múltiplos 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 dividir as gravações de dados em lotes 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 compreensivo de introdução para explorar todas as capacidades do IronXL 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
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
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

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 12
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/ready_to_started_202509.php
Line: 19
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 489
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

Pronto para começar?
Nuget Downloads 1,890,100 | Versão: 2026.3 acaba de ser lançado

Nesta página

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 17
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

A PHP Error was encountered

Severity: Notice

Message: Undefined index: IronXl.Excel

Filename: helpers/counter_helper.php

Line Number: 85

Backtrace:

File: /var/www/ironpdf.com/application/helpers/counter_helper.php
Line: 85
Function: _error_handler

File: /var/www/ironpdf.com/application/views/main/sections/still_scrolling_202512.php
Line: 24
Function: getTotalDonwloadNumber

File: /var/www/ironpdf.com/application/views/products/sections/three_column_docs_page_structure.php
Line: 71
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/views/products/how-to/index.php
Line: 2
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 88
Function: view

File: /var/www/ironpdf.com/application/libraries/Render.php
Line: 552
Function: view

File: /var/www/ironpdf.com/application/controllers/Products/Howto.php
Line: 31
Function: render_products_view

File: /var/www/ironpdf.com/index.php
Line: 292
Function: require_once

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.