Processador de Arquivos XLSX Aspose.Words para .NET

O Aspose.Words XLSX File Processor para .NET permite que você create, abra, modifique e salve XLSX worksbooks inteiramente em código gerenciado.Construído em um subset simplificado do motor Aspos.Cells e projetado para se integrar com o pipeline de conversão Asposa.Verdes, ele fornece geração/editação Excel de alto desempenho para aplicativos de servidor, ferramentas de escritório e serviços de nuvem –sem automação do Office.

Concentro-se no XLSX: folhas de trabalho, células, estilos, fórmula, gráficos, dados de importação/exportação, validação e proteção.

Instalação e Setup

  • Instale o pacote NuGet Aspose.Words (e o Pacote XLSX File Processor plugin, se distribuído separadamente).
  • Aplique a sua licença no aplicativo startup para remover os limites de avaliação: ver Metered Licensing .
  • Para objetivos de quadro e orientação de implementação, consulte Instalação .

Este plug-in usa um motor de Excel cortado internamente e não exige o Microsoft Excel.

As plataformas suportadas são: Windows, Linux, macOS (.NET Framework, .NET Core e Mono).Runtime: x64/x86; ambientes de servidor e desktop.

Início rápido: Criar e salvar um XLSX

using Aspose.Cells; // Engine behind the plugin

// 1) Create a workbook with one worksheet
var wb = new Workbook();
Worksheet sheet = wb.Worksheets[0];
sheet.Name = "Report";

// 2) Populate header + data
sheet.Cells["A1"].PutValue("Product");
sheet.Cells["B1"].PutValue("Qty");
sheet.Cells["C1"].PutValue("Price");
sheet.Cells["D1"].PutValue("Total");

sheet.Cells["A2"].PutValue("Keyboard");
sheet.Cells["B2"].PutValue(12);
sheet.Cells["C2"].PutValue(39.99);
sheet.Cells["D2"].Formula = "=B2*C2";

// 3) Style header
var style = wb.CreateStyle();
style.Font.IsBold = true;
style.ForegroundColor = System.Drawing.Color.AliceBlue;
style.Pattern = BackgroundType.Solid;
var flags = new StyleFlag { FontBold = true, CellShading = true };
sheet.Cells.CreateRange("A1", "D1").ApplyStyle(style, flags);

// 4) Auto-fit and save
sheet.AutoFitColumns();
wb.Save("Report.xlsx", SaveFormat.Xlsx);

Carregar, editar e recalcular

using Aspose.Cells;

var load = new LoadOptions(LoadFormat.Xlsx);
using var fs = File.OpenRead("Input.xlsx");
var wb = new Workbook(fs, load);

// Update a value and a formula
Worksheet ws = wb.Worksheets["Summary"] ?? wb.Worksheets[0];
ws.Cells["B5"].PutValue(1250);            // new revenue
ws.Cells["B6"].Formula = "=B5*0.18";     // tax 18%

// Calculate formulas only for this sheet to save time
var calcOpts = new CalculationOptions { CalcStackSize = 2000 };
wb.CalculateFormula(calcOpts);

wb.Save("Updated.xlsx", SaveFormat.Xlsx);

Dados de importação (DataTable → Worksheet)

using System.Data;
using Aspose.Cells;

DataTable dt = GetData(); // your source
var wb = new Workbook();
var ws = wb.Worksheets[0];

ws.Cells.ImportDataTable(dt, isFieldNameShown: true, firstRow: 0, firstColumn: 0, insertRows: true);
ws.AutoFitColumns();

wb.Save("DataImport.xlsx", SaveFormat.Xlsx);

Insira um gráfico (Bond to Data)

var wb = new Workbook();
var ws = wb.Worksheets[0];

// Sample data
ws.Cells["A1"].PutValue("Month");
ws.Cells["B1"].PutValue("Sales");
string[] months = {"Jan","Feb","Mar","Apr"};
int[] sales = {120, 150, 170, 190};
for (int i = 0; i < months.Length; i++) { ws.Cells[i+1,0].PutValue(months[i]); ws.Cells[i+1,1].PutValue(sales[i]); }

// Add chart
int idx = ws.Charts.Add(ChartType.Column, 6, 0, 20, 8);
Chart chart = ws.Charts[idx];
chart.Title.Text = "Monthly Sales";
chart.NSeries.Add("B2:B5", true);
chart.NSeries.CategoryData = "A2:A5";

wb.Save("Chart.xlsx", SaveFormat.Xlsx);

Adicione Validação de Dados e Proteja uma folha

var wb = new Workbook();
var ws = wb.Worksheets[0];

// Allow only whole numbers between 1 and 100 in B2:B100
Validation v = ws.Validations[ws.Validations.Add()];
v.Type = ValidationType.WholeNumber;
v.Operator = OperatorType.Between;
v.Formula1 = "1";
v.Formula2 = "100";
CellArea area = CellArea.CreateCellArea("B2", "B100");
v.AddArea(area);

// Protect sheet but allow editing unlocked cells
ws.Protection = new Protection { AllowEditingContent = true };
wb.Save("Validated.xlsx", SaveFormat.Xlsx);

Características e Funcionalidade

Livro de trabalho Creation & Loading

  • Novos livros de trabalho com folhas e estilos padrão.
  • Carregue o XLSX de file/stream/byte[] com um relatório de erro robusto.
  • Detectar pacotes protegidos por senha e estruturas invalidas.

Gestão de Worksheet

  • Adicionar/clone/delete/move folhas de trabalho; esconder/unhide tabs.
  • Endereço por index ou nome.

Células & Ranges

  • Leia/Escreva linhas, números, datas, booleanos.
  • Bulk operações sobre as faixas para alta passagem.
  • Economize dados suportados sem exagerar o tamanho do arquivo.

Estilo e formatação

  • Formatos de número e máscaras de data/tempo personalizadas.
  • Fontes, enchentes, fronteiras; estilos nomeados para reutilização.
  • Regras de formatação condicional.

Formulários e Recalculação

  • Todas as funções comuns do Excel (SUM, AVERAGE, VLOOKUP, IF, etc.).
  • Revisão de folhetos ou livros de trabalho completos para o desempenho.
  • Acesso a valores cache e fresco calculados.

Cartões e gráficos

  • Coluna/Bar/Line/Pie/Area/Scatter gráficos.
  • Configure títulos, eixos, lendas, estilos de série.
  • Insira imagens (PNG/JPEG/BMP) com controle de posição e tamanho.

Import/Exportação de Dados

  • Importação de DataTable , arraios, ou IEnumerable<T>.
  • As exportações variam de volta para DataTable/colecções.
  • Save Cv para a troca de dados leve.

Validação e Proteção

  • Lista / número / data / regras de validação personalizadas.
  • Proteção de folha de trabalho com bloqueio seletivo e senha.

Performance e Memória

  • Escrito em streaming, atualizações batidas, memória previsível.
  • Modo de cálculo manual durante as operações em massa.
  • Disponível rapidamente (Utilização using) para os recursos livres.

Tipos e Melhores Práticas

  • Batch escreve para faixas contínuas; evite caídas por células quando possível.
  • Reutilizar ** estilos denominados** para reduzir a duplicação de estilo.
  • Configure o modo de cálculo ** para Manual** durante grandes importações, recalque uma vez no final.
  • Valida as entradas antes de escrever para evitar exceções.
  • Comprimir grandes imagens antes da inserção para manter os arquivos suaves.
  • Cerca/disponha livros de trabalho para flush e recursos livres.
  • Quando você só precisa de valores, prefere resultados caixados para perder a recalculação.

FAQ

**Preciso de um Excel instalado?**No. O motor é totalmente gerenciado e sem cabeça.

**Quais formatos eu posso ler/escrever?**Este processador concentra-se no XLSX . Para formatos Excel mais amplos (xLS, ODS) use o produto completo Aspose.Cells.

**Posso calcular as fórmulas do servidor?**Sim – Use Workbook.CalculateFormula com opções de desempenho.

**Quais são os limites do Excel?**O XLSX suporta até 1,048,576 linhas × 16,384 colunas por folha de trabalho.

**Como isso se relaciona com Aspose.Words?**Ele integra-se em tubos centrais em Words (por exemplo, converter Word→XLSX ou adicionar saídas XLSX) enquanto se baseia em um motor de Excel cortado internamente.

 Português