Como Criar, Abrir e Editar Planilha Excel em C# (Sem Interop) com IronXL

Open, write, save, and customize Excel files with the easy-to-use IronXL C# library.

Download a sample project from GitHub or use your own, and follow the tutorial.

1. Install the IronXL.Excel Library from NuGet or the DLL download
2. Use o método WorkBook.Load para ler qualquer documento XLS, XLSX ou CSV.
3. Obtenha os valores das células usando uma sintaxe intuitiva: sheet["A11"].DecimalValue

Neste tutorial, vamos guiá-lo(a) através dos seguintes passos:

• Instalando IronXL.Excel: como instalar IronXL.Excel em um projeto existente.
• Operações básicas: etapas básicas de operação no Excel para criar ou abrir uma pasta de trabalho, selecionar uma planilha, selecionar uma célula e salvar a pasta de trabalho.
• Operações avançadas em planilhas: como utilizar diferentes recursos de manipulação, como adicionar cabeçalhos ou rodapés, operações matemáticas e outras funcionalidades.

Abrir um arquivo do Excel: Código rápido

:path=/static-assets/excel/content-code-examples/tutorials/csharp-open-write-excel-file-1.cs

using IronXL;

WorkBook workBook = WorkBook.Load("test.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;
IronXL.Range range = workSheet["A2:A8"];
decimal total = 0;

// iterate over range of cells
foreach (var cell in range)
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.RowIndex, cell.Value);
    if (cell.IsNumeric)
    {
        // Get decimal value to avoid floating numbers precision issue
        total += cell.DecimalValue;
    }
}

// Check formula evaluation
if (workSheet["A11"].DecimalValue == total)
{
    Console.WriteLine("Basic Test Passed");
}

Imports IronXL

Private workBook As WorkBook = WorkBook.Load("test.xlsx")
Private workSheet As WorkSheet = workBook.DefaultWorkSheet
Private range As IronXL.Range = workSheet("A2:A8")
Private total As Decimal = 0

' iterate over range of cells
For Each cell In range
	Console.WriteLine("Cell {0} has value '{1}'", cell.RowIndex, cell.Value)
	If cell.IsNumeric Then
		' Get decimal value to avoid floating numbers precision issue
		total += cell.DecimalValue
	End If
Next cell

' Check formula evaluation
If workSheet("A11").DecimalValue = total Then
	Console.WriteLine("Basic Test Passed")
End If

Escrever e salvar alterações no arquivo do Excel: Código rápido

:path=/static-assets/excel/content-code-examples/tutorials/csharp-open-write-excel-file-2.cs

workSheet["B1"].Value = 11.54;

// Save Changes
workBook.SaveAs("test.xlsx");

workSheet("B1").Value = 11.54

' Save Changes
workBook.SaveAs("test.xlsx")

Passo 1

Instale a biblioteca do Excel no seu projeto do Visual Studio com o NuGet.

O primeiro passo será instalar IronXL.Excel. Para adicionar a biblioteca IronXL.Excel ao projeto, temos duas maneiras: Gerenciador de Pacotes NuGet ou Console do Gerenciador de Pacotes NuGet .

Para adicionar a biblioteca IronXL.Excel ao nosso projeto usando o NuGet, podemos fazê-lo através de uma interface visual, o Gerenciador de Pacotes NuGet :

1. Usando o mouse -> clique com o botão direito do mouse no nome do projeto -> selecione Gerenciar Pacotes NuGet
   
2. Na guia Procurar -> pesquise por IronXL.Excel -> Instalar
   
3. E terminamos.
   

Instale usando o console do Gerenciador de Pacotes NuGet.

1. Em Ferramentas -> Gerenciador de Pacotes NuGet -> Console do Gerenciador de Pacotes
   
2. Execute o comando

Install-Package IronXL.Excel

Instalação manual com a DLL

2.1. Projeto de exemplo: HelloWorld Aplicativo de console

Crie um projeto HelloWorld no Visual Studio.

1. Abra o Visual Studio
   
2. Selecione Criar novo projeto
   
3. Escolha Aplicativo de Console (framework .NET)
   
4. Dê o nome de "HelloWorld" ao exemplo e clique em Criar.
   
5. Agora o aplicativo de console foi criado.
   
6. Adicione IronXL.Excel ao seu projeto -> clique em instalar
   
7. Adicione o código para ler a primeira célula da primeira planilha de um arquivo Excel e imprimi-la.

using IronXL;

var workbook = WorkBook.Load("example.xlsx");
var sheet = workbook.DefaultWorkSheet;
Console.WriteLine(sheet["A1"].Text);

using IronXL;

var workbook = WorkBook.Load("example.xlsx");
var sheet = workbook.DefaultWorkSheet;
Console.WriteLine(sheet["A1"].Text);

Imports IronXL

Private workbook = WorkBook.Load("example.xlsx")
Private sheet = workbook.DefaultWorkSheet
Console.WriteLine(sheet("A1").Text)

...

Leitura complementar

Para aprender mais sobre como trabalhar com o IronXL, você pode consultar outros tutoriais nesta seção, bem como os exemplos em nossa página inicial, que a maioria dos desenvolvedores considera suficientes para começar.
Nossa Referência de API contém referências específicas à classe WorkBook.