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 as complexas dependências de interoperabilidade com o Excel e funciona perfeitamente em aplicações .NET .

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

Use a API de linha única do IronXL para gerar uma nova planilha 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

Fluxo de trabalho mínimo (5 etapas)

  1. Baixe a biblioteca C# para criar planilhas
  2. Use o método estático Create para criar uma planilha
  3. Escolha se deseja criar um arquivo XLSX ou XLS
  4. Exporte a planilha e verifique o arquivo do Excel.
  5. Use a classe CreatingOptions para configurar a criação do livro


Como criar uma planilha básica em C#?

Use o método estático Create para criar uma pasta de trabalho do Excel que possa armazenar uma coleção de planilhas. Por padrão, este método cria uma planilha 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 ligo para WorkBook.Create()?

Ao chamar WorkBook.Create(), o IronXL inicializa um novo objeto de planilha 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 utiliza o padrão Open XML, introduzido no Office 2007. O XLSX oferece suporte a recursos avançados, como gráficos e formatação condicional, e é amplamente utilizado para análise de dados e tarefas comerciais. 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 atual do setor, oferecendo melhor compressão, recuperação de dados aprimorada e suporte para recursos modernos do Excel. Os 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. Não possui as características 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 uma enumeração ExcelFileFormat que especifica se deve ser criado um arquivo XLSX ou XLS. Ambos os formatos de arquivo armazenam planilhas do Microsoft Excel, sendo o XLSX o formato moderno baseado em XML introduzido no Office 2007, enquanto o XLS é o formato binário mais antigo usado em versões anteriores. XLS é agora menos comum devido às suas funcionalidades limitadas 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 somente quando:

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

Para todos os outros cenários, recomenda-se o XLSX 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 possui apenas uma propriedade, DefaultFileFormat, que configura se um arquivo XLSX ou XLS será criado. Veja o código abaixo como 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. O IronXL suporta a gravação 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!
' 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 descarte os objetos workbook ao terminar, 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 completo de primeiros passos para explorar todos os recursos do IronXl.Excel para automação do 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
Pronto para começar?
Nuget Downloads 2,052,917 | Versão: 2026.6 just released
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.