Como Converter Planilha Excel para Outros Formatos em C# com IronXL

Como Converto Tipos de Arquivo de Planilha?

O processo de conversão de tipos de planilha envolve carregar um arquivo em um formato suportado e exportá-lo para outro formato utilizando as capacidades inteligentes de reestruturação de dados do IronXL. Este processo de conversão preserva a integridade dos dados enquanto se adapta aos requisitos estruturais de cada formato de destino.

Embora o método SaveAs possa ser usado para exportar para CSV, JSON, XML e HTML, é recomendável usar os métodos dedicados para cada formato de arquivo:

• SaveAsCsv - Otimizado para valores separados por vírgula com escape adequado
• SaveAsJson - Cria JSON devidamente formatado com preservação do tipo de dado
• SaveAsXml - Gera XML bem formatado com esquema apropriado
• ExportToHtml - Produz tabelas HTML estilizadas com formatação mantida

:path=/static-assets/excel/content-code-examples/how-to/convert-spreadsheet-file-types-different-format.cs

using IronXL;

// Load the Excel spreadsheet
WorkBook workbook = WorkBook.Load("sample.xlsx");

// Convert and save as CSV
workbook.SaveAsCsv("sample.csv");

// Convert and save as JSON
workbook.SaveAsJson("sample.json");

// Convert and save as XML
workbook.SaveAsXml("sample.xml");

// Convert and export to HTML
workbook.ExportToHtml("sample.html");

// The files will be saved in the project's directory with the specified formats

Imports IronXL

' Load the Excel spreadsheet
Dim workbook As WorkBook = WorkBook.Load("sample.xlsx")

' Convert and save as CSV
workbook.SaveAsCsv("sample.csv")

' Convert and save as JSON
workbook.SaveAsJson("sample.json")

' Convert and save as XML
workbook.SaveAsXml("sample.xml")

' Convert and export to HTML
workbook.ExportToHtml("sample.html")

' The files will be saved in the project's directory with the specified formats

Cada método de exportação é otimizado para seu formato-alvo. Por exemplo, converter XLSX para CSV lida corretamente com caracteres especiais e delimitadores, enquanto a exportação JSON mantém tipos de dados e estruturas hierárquicas.

Quais opções avançadas de conversão estão disponíveis?

Na seção anterior, exploramos os formatos de arquivo mais comuns para conversão. No entanto, o IronXL tem a capacidade de converter planilhas para muitos outros formatos. Explore todas as opções disponíveis para carregar e exportar planilhas, incluindo cenários avançados como exportar para DataSet e DataTable para operações de banco de dados.

:path=/static-assets/excel/content-code-examples/how-to/convert-spreadsheet-file-types-different-format-advanced.cs

using IronXL;

// Load the Excel spreadsheet
WorkBook workbook = WorkBook.Load("advanced_sample.xlsx");

// Convert and save to various formats
workbook.SaveAs("advanced_sample.xlsm");
workbook.SaveAsCsv("advanced_sample.csv");
workbook.SaveAsJson("advanced_sample.json");
workbook.SaveAsXml("advanced_sample.xml");
workbook.ExportToHtml("advanced_sample.html");

// You can also convert to binary or byte array for advanced uses
byte[] excelAsByteArray = workbook.ToBinary();

Imports IronXL

' Load the Excel spreadsheet
Dim workbook As WorkBook = WorkBook.Load("advanced_sample.xlsx")

' Convert and save to various formats
workbook.SaveAs("advanced_sample.xlsm")
workbook.SaveAsCsv("advanced_sample.csv")
workbook.SaveAsJson("advanced_sample.json")
workbook.SaveAsXml("advanced_sample.xml")
workbook.ExportToHtml("advanced_sample.html")

' You can also convert to binary or byte array for advanced uses
Dim excelAsByteArray As Byte() = workbook.ToBinary()

Como é a aparência da saída convertida?

Arquivo XLSX

Os vários arquivos exportados são mostrados abaixo.

Exportação de Arquivo TSV

Exportação de Arquivo CSV

Exportação de Arquivo JSON

Exportação de Arquivo XML

Exportação de Arquivo HTML

Melhores práticas para conversão de arquivos

Ao converter arquivos de planilhas, considere estas melhores práticas para garantir resultados ideais:

1. Preserve a Integridade dos Dados: Sempre verifique se os dados críticos, fórmulas e formatação são mantidos após a conversão. Alguns formatos, como CSV, não suportam várias planilhas ou formatação.

2. Lide com Arquivos Grandes de Forma Eficiente: Para grandes planilhas, considere usar métodos de streaming ou processar dados em partes para gerenciar o uso de memória de forma eficaz.

3. Tratamento de Erros: Implemente tratativas adequadas para capturar falhas de conversão:

try 
{
    WorkBook workbook = WorkBook.Load("input.xlsx");

    // Check if the file has data before converting
    if (workbook.WorkSheets.Count > 0 && workbook.DefaultWorkSheet.RowCount > 0)
    {
        workbook.SaveAsCsv("output.csv");
        Console.WriteLine("Conversion successful!");
    }
    else
    {
        Console.WriteLine("No data found in the spreadsheet.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Conversion failed: {ex.Message}");
}

try 
{
    WorkBook workbook = WorkBook.Load("input.xlsx");

    // Check if the file has data before converting
    if (workbook.WorkSheets.Count > 0 && workbook.DefaultWorkSheet.RowCount > 0)
    {
        workbook.SaveAsCsv("output.csv");
        Console.WriteLine("Conversion successful!");
    }
    else
    {
        Console.WriteLine("No data found in the spreadsheet.");
    }
}
catch (Exception ex)
{
    Console.WriteLine($"Conversion failed: {ex.Message}");
}

Imports System

Try
    Dim workbook As WorkBook = WorkBook.Load("input.xlsx")

    ' Check if the file has data before converting
    If workbook.WorkSheets.Count > 0 AndAlso workbook.DefaultWorkSheet.RowCount > 0 Then
        workbook.SaveAsCsv("output.csv")
        Console.WriteLine("Conversion successful!")
    Else
        Console.WriteLine("No data found in the spreadsheet.")
    End If
Catch ex As Exception
    Console.WriteLine($"Conversion failed: {ex.Message}")
End Try

4. Escolha o Formato Correto: Selecione o formato de saída com base em suas necessidades específicas:

   • Use XLSX para total funcionalidade do Excel
   • Escolha CSV para troca de dados simples
   • Selecione JSON para aplicativos web e APIs
   • Escolha XML para dados estruturados com esquemas
   • Exporte para HTML para exibição na web
5. Codificação de Caracteres: Preste atenção à codificação de caracteres, especialmente ao lidar com dados internacionais. O IronXL manipula a codificação UTF-8 por padrão, garantindo representação adequada de caracteres em diferentes sistemas.

Para orientações mais detalhadas sobre o trabalho com arquivos do Excel em aplicações .NET, explore a extensa documentação do IronXL.