Uma comparação entre IronXL e Microsoft Office Interop Excel

Conjunto de Recursos do IronXL

• Carregar, Ler e Editar Dados — a partir de XLS/XLSX/CSV/TSV
• Salvando e Exportando — para XLS/XLSX/CSV/TSV/JSON
• Objetos System.Data — Trabalhe com planilhas do Excel como objetos System.Data.DataSet e System.Data.DataTable.
• Fórmulas — funciona com fórmulas Excel. As fórmulas são recalculadas toda vez que uma planilha é editada.
• Intervalos — Sintaxe de planilha fácil de usar ["A1:B10"]. Combine e crie intervalos de forma intuitiva.
• Ordenação — Ordenar Intervalos, Colunas e Linhas.
• Estilização — Estilos visuais de células, fonte, tamanho, padrão de fundo, borda, alinhamento e formatos numéricos.

2.1. Usando o Visual Studio com pacotes NuGet

O Visual Studio fornece o Gerenciador de Pacotes NuGet para instalar pacotes NuGet em seus projetos. Você pode acessá-lo através do Menu Projeto, ou clicando com o botão direito do mouse no seu projeto no Solution Explorer.

• Agora, na aba de navegação -> procure por IronXl.Excel -> Instalar

• E pronto.

3.2. Usando o Console do Gerenciador de Pacotes NuGet

Outra maneira de baixar e instalar a Biblioteca C# Microsoft.Office.Interop.Excel é fazer uso dos seguintes passos para instalar o pacote NuGet através do Prompt de Comando do Desenvolvedor.

1. Abra o Prompt de Comando do Desenvolvedor — geralmente encontrado na pasta do Visual Studio.

2. Digite o seguinte comando:

   PM> Install-Package Microsoft.Office.Interop.Excel

   PM> Install-Package Microsoft.Office.Interop.Excel

   SHELL
3. Pressione Enter.
4. Isso irá baixar e instalar o pacote.
5. Recarregue seu projeto do Visual Studio e comece a usar.

3.3. Adicione as diretivas de uso necessárias

1. No Solution Explorer, clique com o botão direito no arquivo Program.cs e, em seguida, clique em Ver Código.

2. Adicione a seguinte diretiva de uso ao topo do arquivo de código:

   using Excel = Microsoft.Office.Interop.Excel;

   using Excel = Microsoft.Office.Interop.Excel;

   $vbLabelText   $csharpLabel

4.1. Um Novo Livro e Folha de Excel usando IronXL

Não poderia ser mais fácil criar um novo Livro de Excel usando IronXL! Apenas uma linha de código! Sim, realmente. Adicione o seguinte código à sua função estática void Main no arquivo Program.cs:

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

Ambos os formatos de arquivo XLS (versão de arquivo do Excel mais antiga) e XLSX (versão de arquivo atual e mais nova) podem ser criados com IronXL.

E, é ainda mais fácil criar uma Planilha padrão:

// Create a new worksheet
var worksheet = workbook.CreateWorkSheet("IronXL Features");

// Create a new worksheet
var worksheet = workbook.CreateWorkSheet("IronXL Features");

Você pode agora usar a variável worksheet para definir valores de células e fazer quase tudo que um arquivo Excel pode fazer.

4.2. Um Novo Livro e Folha de Excel usando Microsoft.Office.Interop.Excel

Para criar um arquivo de Excel usando Microsoft.Office.Interop, é necessário que o Microsoft Excel esteja instalado. Portanto, precisamos verificar se o Microsoft Excel está instalado na máquina host — caso contrário, isso irá simplesmente retornar uma exceção que precisa ser tratada. Os exemplos de código a seguir permitem que você verifique uma instalação do aplicativo Excel e crie livros e folhas de Excel:

Verifique se o Microsoft Excel está instalado:

// Start Excel and get Application object.
Excel.Application xlApp = new Excel.Application();  

// Check if Excel is installed  
if (xlApp == null)  
{  
    Console.WriteLine("Excel is not installed in the system...");
    return;  
}

// Start Excel and get Application object.
Excel.Application xlApp = new Excel.Application();  

// Check if Excel is installed  
if (xlApp == null)  
{  
    Console.WriteLine("Excel is not installed in the system...");
    return;  
}

Criar Livro e Folha de Trabalho:

// Create Workbook and Worksheet
object misValue = System.Reflection.Missing.Value;  
Excel.Workbook xlWorkBook = xlApp.Workbooks.Add(misValue);  
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.Worksheets.get_Item(1);

// Create Workbook and Worksheet
object misValue = System.Reflection.Missing.Value;  
Excel.Workbook xlWorkBook = xlApp.Workbooks.Add(misValue);  
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.Worksheets.get_Item(1);

Até agora, olhando para ambos os códigos, a vantagem está com o IronXL sobre o Office Interop Excel. IronXL usa apenas uma linha de código para poder trabalhar com arquivos Excel, sem complicações e dependências adicionais.

5.1. Ler Arquivos Excel usando IronXL

A classe WorkBook do IronXL representa uma planilha Excel. Para abrir um arquivo Excel usando C#, usamos WorkBook.Load e especificamos o caminho do arquivo Excel (.xlsx). O seguinte código de uma linha é usado para abrir o arquivo para leitura:

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

// Load WorkBook
var workbook = WorkBook.Load(@"Spreadsheets\\sample.xlsx");

Cada WorkBook pode ter múltiplos objetos WorkSheet. Estes representam as planilhas no documento Excel. Se o workbook contém planilhas, recupere-as pelo nome da seguinte forma:

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

// Open Sheet for reading
var worksheet = workbook.GetWorkSheet("sheetnamegoeshere");

Código para leitura dos valores das células:

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read from Ranges of cells elegantly.
foreach (var cell in worksheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

5.2. Ler Arquivos Excel usando Microsoft.Office.Interop.Excel

Isso também usa uma linha de código para abrir um livro e folha. O código é o seguinte:

Excel.Application xlApp = new Excel.Application();  

// Load WorkBook
Excel.Workbook xlWorkBook = xlApp.Workbooks.Open(filePath);  

// Open Sheet for reading
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.Worksheets.get_Item(1);

Excel.Application xlApp = new Excel.Application();  

// Load WorkBook
Excel.Workbook xlWorkBook = xlApp.Workbooks.Open(filePath);  

// Open Sheet for reading
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.Worksheets.get_Item(1);

Código para leitura dos valores das células:

// Get the entire range of cells
Excel.Range xlRange = xlWorkSheet.UsedRange;

// Reading first 10 rows with two columns
for (int rowCount = 1; rowCount <= 10; rowCount++)  
{  
    string firstValue = Convert.ToString((xlRange.Cells[rowCount, 1] as Excel.Range).Text);  
    string secondValue = Convert.ToString((xlRange.Cells[rowCount, 2] as Excel.Range).Text);  

    Console.WriteLine(firstValue + "\t" + secondValue);  
}

// Get the entire range of cells
Excel.Range xlRange = xlWorkSheet.UsedRange;

// Reading first 10 rows with two columns
for (int rowCount = 1; rowCount <= 10; rowCount++)  
{  
    string firstValue = Convert.ToString((xlRange.Cells[rowCount, 1] as Excel.Range).Text);  
    string secondValue = Convert.ToString((xlRange.Cells[rowCount, 2] as Excel.Range).Text);  

    Console.WriteLine(firstValue + "\t" + secondValue);  
}

No entanto, verificar a instalação do Excel e criar sua instância é uma parte integral.

6.1. Trabalhando com Intervalo de Valores Usando IronXL

No IronXL, com uma linha de código, podemos obter o intervalo de valores de células específicas. Em seguida, usando um loop, cada valor de célula pode ser lido ou editado. O código é o seguinte:

// Load the workbook and get the first worksheet
WorkBook workbook = WorkBook.Load("test.xls");
WorkSheet sheet = workbook.WorkSheets.First();

// This is how we get range from Excel worksheet
var range = sheet["A2:A8"];
// This is how we can iterate over our range and read or edit any cell
foreach (var cell in range)
{
    Console.WriteLine(cell.Value);
}

// Load the workbook and get the first worksheet
WorkBook workbook = WorkBook.Load("test.xls");
WorkSheet sheet = workbook.WorkSheets.First();

// This is how we get range from Excel worksheet
var range = sheet["A2:A8"];
// This is how we can iterate over our range and read or edit any cell
foreach (var cell in range)
{
    Console.WriteLine(cell.Value);
}

6.2. Trabalhando com Intervalo de Valores Usando Microsoft.Office.Interop.Excel

Isso também usa uma linha de código para obter o intervalo de valores das células. As células podem então ser atualizadas com os valores necessários. O código é o seguinte:

Excel.Application xlApp = new Excel.Application();  
Excel.Workbook xlWorkBook = xlApp.Workbooks.Open(filePath);  
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.Worksheets.get_Item(1);

// Get range of values and updating their format
var range = xlWorkSheet.get_Range("A1", "D1");
range.NumberFormat = "$0.00";

Excel.Application xlApp = new Excel.Application();  
Excel.Workbook xlWorkBook = xlApp.Workbooks.Open(filePath);  
Excel.Worksheet xlWorkSheet = (Excel.Worksheet)xlWorkBook.Worksheets.get_Item(1);

// Get range of values and updating their format
var range = xlWorkSheet.get_Range("A1", "D1");
range.NumberFormat = "$0.00";

7.1. Trabalhando com Fórmulas do Excel usando IronXL

Após carregar o livro de trabalho e a planilha, o seguinte exemplo de código pode ser utilizado para fazer alterações nas fórmulas ou aplicá-las a células específicas. O código é o seguinte:

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

// Set Formulas
worksheet["A1"].Formula = "Sum(B8:C12)";
worksheet["B8"].Formula = "=C9/C11";
worksheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.  
workbook.EvaluateAll();

Você também pode recuperar fórmulas e seus valores.

// Get Formulas
// Get the formula's calculated value.  e.g. "52"
string formulaValue = worksheet["G30"].Value;

// Get the formula as a string. e.g. "Max(C3:C7)"
string formulaString = worksheet["G30"].Formula;

// Save your changes with updated formulas and calculated values.
workbook.Save();

// Get Formulas
// Get the formula's calculated value.  e.g. "52"
string formulaValue = worksheet["G30"].Value;

// Get the formula as a string. e.g. "Max(C3:C7)"
string formulaString = worksheet["G30"].Formula;

// Save your changes with updated formulas and calculated values.
workbook.Save();

7.2. Trabalhando com Fórmulas do Excel usando Microsoft.Office.Interop.Excel

Da mesma forma, após carregar o livro de trabalho e a planilha, o seguinte código pode ser usado para trabalhar em fórmulas do Excel. O exemplo de código é o seguinte:

// Get range of values and updating their format
var range1 = xlWorkSheet.get_Range("A1", "D1");
var range2 = xlWorkSheet.get_Range("C2", "C6");

// Set Formula
range1.Formula = "=RAND()*100000";
range2.Formula = "=A2 & \" \" & B2";

// Get range of values and updating their format
var range1 = xlWorkSheet.get_Range("A1", "D1");
var range2 = xlWorkSheet.get_Range("C2", "C6");

// Set Formula
range1.Formula = "=RAND()*100000";
range2.Formula = "=A2 & \" \" & B2";