Como carregar planilhas existentes em C#

Quais formatos de arquivo posso carregar?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-spreadsheet.cs

using IronXL;

// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

A flexibilidade para carregar múltiplos formatos de arquivo significa que você pode trabalhar com arquivos Excel legados (XLS), livros de trabalho modernos do Excel (XLSX), livros de trabalho habilitados para macros (XLSM) e arquivos de modelo (XLTX). Esta compatibilidade garante uma migração suave de sistemas antigos enquanto suporta recursos modernos do Excel. Para mais detalhes sobre criar novas planilhas, confira nosso guia abrangente.

Como Lidar com Arquivos Protegidos por Senha?

Trabalhar com dados sensíveis muitas vezes requer proteção por senha. O IronXL torna simples carregar livros de trabalho protegidos por senha fornecendo a senha como parâmetro:

// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");

// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";

// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");

// Load password-protected Excel file
WorkBook protectedWorkBook = WorkBook.Load("protected.xlsx", "myPassword123");

// Work with the workbook normally
WorkSheet sheet = protectedWorkBook.DefaultWorkSheet;
sheet["B2"].Value = "Updated secure data";

// Save with password protection
protectedWorkBook.SaveAs("updated_protected.xlsx");

E Quanto ao Carregamento de Arrays de Bytes ou Streams?

Em aplicações modernas, os arquivos muitas vezes vêm de várias fontes, como uploads web, respostas de APIs ou BLOBs de banco de dados. O IronXL lida com esses cenários de forma elegante:

// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);

// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
    WorkBook workBookFromStream = WorkBook.FromStream(stream);

    // Process the workbook
    var sheet = workBookFromStream.DefaultWorkSheet;
    Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}

// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
    WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}

// Loading from byte array
byte[] excelBytes = File.ReadAllBytes("sample.xlsx");
WorkBook workBookFromBytes = WorkBook.FromByteArray(excelBytes);

// Loading from stream
using (FileStream stream = new FileStream("sample.xlsx", FileMode.Open))
{
    WorkBook workBookFromStream = WorkBook.FromStream(stream);

    // Process the workbook
    var sheet = workBookFromStream.DefaultWorkSheet;
    Console.WriteLine($"Sheet has {sheet.RowCount} rows");
}

// Loading from MemoryStream (common in web applications)
using (MemoryStream memStream = new MemoryStream(excelBytes))
{
    WorkBook workBookFromMemory = WorkBook.FromStream(memStream);
}

Quando LoadCSV É Melhor que Load?

O método LoadCSV proporciona controle aprimorado sobre a análise de CSV, tornando-o ideal quando você precisa especificar delimitadores personalizados, lidar com diferentes codificações ou trabalhar com grandes arquivos CSV. É particularmente útil ao lidar com formatos de dados internacionais ou quando arquivos CSV usam delimitadores não padrão, como ponto e vírgula ou barras verticais.

Como LoadCSV Lida com Caracteres Especiais?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-csv.cs

using IronXL;

// Load CSV file
WorkBook workBook = WorkBook.LoadCSV("sample.csv");

O método LoadCSV lida automaticamente com várias codificações, incluindo UTF-8, UTF-16 e ASCII, garantindo que caracteres especiais, letras acentuadas e símbolos internacionais sejam preservados corretamente. Isso é crucial ao trabalhar com dados multilíngues ou notação científica. Saiba mais sobre escrever arquivos CSV em .NET para uma gestão completa do fluxo de trabalho CSV.

Por Que Eu Converteria DataSet para Excel?

Converter objetos DataSet para formato Excel é essencial para relatórios, exportação de dados e criação de apresentações de dados amigáveis ao usuário. Usuários de negócios muitas vezes preferem formatos Excel para análise de dados, e relatórios automatizados frequentemente precisam transformar resultados de banco de dados em formatos de planilha. Esta conversão habilita recursos como formatação condicional, criação de gráficos e aplicação de fórmulas que não estão disponíveis em objetos DataSet brutos.

O Que Acontece com Relações de DataSet no Excel?

Ao carregar um DataSet com múltiplas tabelas relacionadas, o IronXL cria planilhas separadas para cada DataTable no DataSet. As relações de tabelas são preservadas através de valores de chave consistentes, permitindo que os usuários mantenham a integridade dos dados ao trabalhar com o arquivo Excel exportado. Isso o torna ideal para exportar esquemas de banco de dados complexos enquanto mantém a integridade referencial.

Posso Carregar Múltiplas Tabelas de DataSet?

:path=/static-assets/excel/content-code-examples/how-to/load-spreadsheet-load-dataset.cs

using IronXL;
using System.Data;

// Create dataset
DataSet dataSet = new DataSet();

// Create workbook
WorkBook workBook = WorkBook.Create();

// Load DataSet
WorkBook.LoadWorkSheetsFromDataSet(dataSet, workBook);

Para cenários mais avançados envolvendo integração com banco de dados, explore nosso guia sobre Excel para SQL via System.Data.DataSet que demonstra o fluxo de dados bidirecional entre Excel e bancos de dados.

A capacidade de carregar várias fontes de dados em formato Excel torna o IronXL uma ferramenta inestimável para desenvolvedores .NET. Quer você esteja construindo sistemas de relatórios, ferramentas de migração de dados ou aplicações de inteligência de negócios, as capacidades de carregamento fornecem a base para uma manipulação poderosa de planilhas. Para mais exemplos e técnicas avançadas, visite nossa seção de tutoriais abrangentes.