Aspose.Cells Software Livre e de Código Aberto

Casos de Uso do Aspose.Cells FOSS para .NET

Aspose.Cells FOSS for .NET é uma biblioteca .NET totalmente gerenciada que lê e grava arquivos XLSX sem exigir Microsoft Office ou quaisquer dependências externas. Os casos de uso a seguir ilustram onde a biblioteca se encaixa em aplicações .NET do mundo real.

Geração de Relatórios

Gere relatórios XLSX programaticamente em aplicações server-side ou em lote. Use Workbook, Worksheet e Cell.PutValue() para escrever dados estruturados, então chame Workbook.Save() para produzir o arquivo.

using Aspose.Cells_FOSS;

var wb = new Workbook();
var ws = wb.Worksheets[0];
ws.Name = "Monthly Report";

ws.Cells["A1"].PutValue("Product");
ws.Cells["B1"].PutValue("Revenue");

ws.Cells["A2"].PutValue("Widget A");
ws.Cells["B2"].PutValue(12500.00m);

ws.Cells["A3"].PutValue("Widget B");
ws.Cells["B3"].PutValue(8750.00m);

ws.Cells["B4"].Formula = "=SUM(B2:B3)";

wb.Save("monthly-report.xlsx");

Esse padrão escala para qualquer número de linhas e pode ser alimentado por dados de um banco de dados ou resposta de API.

Processando Planilhas Carregadas

Leia e valide arquivos XLSX enviados pelos usuários por meio de um formulário da web ou endpoint de API. O construtor Workbook aceita um Stream, portanto nenhum arquivo temporário precisa ser gravado no disco.

using Aspose.Cells_FOSS;

// IFormFile from ASP.NET Core controller
public async Task<IActionResult> Upload(IFormFile file)
{
    using var stream = file.OpenReadStream();
    var opts = new LoadOptions { TryRepairPackage = true };
    var wb = new Workbook(stream, opts);

    var ws = wb.Worksheets[0];
    var firstRow = ws.Cells["A1"].StringValue;
    // ... validate and process rows

    return Ok(new { sheets = wb.Worksheets.Count, firstCell = firstRow });
}

Use LoadDiagnostics.HasRepairs para detectar arquivos que requeriam reparo estrutural e exibir essa informação aos usuários.

Extração de Pipeline de Dados

Extraia dados de células de exportações XLSX produzidas por sistemas de terceiros e alimente os valores em um banco de dados ou serviço downstream. Leia os valores das células via Cell.StringValue e Cell.Value usando coordenadas de linha e coluna.

using Aspose.Cells_FOSS;

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

var records = new List<(string sku, double qty)>();
for (int row = 1; row <= 100; row++) // iterate known data range
{
    var sku = ws.Cells[row, 0].StringValue;
    if (string.IsNullOrEmpty(sku)) break;
    var qty = (double)ws.Cells[row, 1].Value;
    records.Add((sku, qty));
}

Console.WriteLine($"Extracted {records.Count} records");

Aplicando Validação de Dados Antes de Salvar

Adicione regras de validação de lista suspensa ou intervalo antes de entregar um modelo XLSX aos usuários finais, garantindo que eles preencham apenas valores aceitáveis.

using Aspose.Cells_FOSS;

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

// Status column: dropdown
var statusVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("A2", "A100"))];
statusVal.Type = ValidationType.List;
statusVal.Formula1 = "\"Open,In Progress,Closed\"";
statusVal.InCellDropDown = true;

// Score column: 0–10 decimal range
var scoreVal = ws.Validations[ws.Validations.Add(CellArea.CreateCellArea("B2", "B100"))];
scoreVal.Type = ValidationType.Decimal;
scoreVal.Operator = OperatorType.Between;
scoreVal.Formula1 = "0";
scoreVal.Formula2 = "10";
scoreVal.ShowError = true;

wb.Save("template-with-validation.xlsx");

Estilizando a Saída para Legibilidade

Aplicar estilos de célula — fontes, cores de preenchimento, formatos numéricos, bordas — para produzir uma saída polida. Crie uma instância Style diretamente, configure suas propriedades e aplique-a com Cell.SetStyle().

using Aspose.Cells_FOSS;

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

// Header style
var headerStyle = new Style();
headerStyle.Font.IsBold = true;
headerStyle.Font.Size = 12;
headerStyle.ForegroundColor = System.Drawing.Color.FromArgb(0x4F, 0x81, 0xBD);
headerStyle.Pattern = FillPattern.Solid;

ws.Cells["A1"].PutValue("Name");
ws.Cells["B1"].PutValue("Score");
ws.Cells["A1"].SetStyle(headerStyle);
ws.Cells["B1"].SetStyle(headerStyle);

// Number format for score column
var numStyle = new Style();
numStyle.Custom = "0.00";
ws.Cells["B2"].SetStyle(numStyle);
ws.Cells["B2"].PutValue(98.5m);

wb.Save("styled-report.xlsx");