Případy použití Aspose.Cells FOSS pro .NET

Aspose.Cells FOSS pro .NET je čistě spravovaná knihovna .NET, která čte a zapisuje soubory XLSX, aniž by vyžadovala Microsoft Office nebo jakékoli externí závislosti. Následující příklady použití ukazují, kde knihovna zapadá do reálných .NET aplikací.

Generování zpráv

Generujte XLSX zprávy programově na serverové straně nebo v dávkových aplikacích. Použijte Workbook, Worksheet a Cell.PutValue() k zápisu strukturovaných dat, poté zavolejte Workbook.Save() k vytvoření souboru.

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");

Tento vzor se škáluje na libovolný počet řádků a může být řízen daty z databáze nebo odpovědi API.

Zpracování nahraných tabulek

Čtěte a ověřujte soubory XLSX odeslané uživateli prostřednictvím webového formuláře nebo koncového bodu API. Konstruktor Workbook přijímá Stream, takže není nutné zapisovat dočasný soubor na disk.

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 });
}

Použijte LoadDiagnostics.HasRepairs k detekci souborů, které vyžadovaly strukturální opravu, a zobrazte tyto informace uživatelům.

Extrahování datové pipeline

Extrahujte data buněk z exportů XLSX vytvořených systémy třetích stran a vložte hodnoty do databáze nebo následné služby. Čtěte hodnoty buněk pomocí Cell.StringValue a Cell.Value pomocí souřadnic řádku a sloupce.

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");

Použití ověření dat před uložením

Přidejte před doručením šablony XLSX koncovým uživatelům pravidla pro rozbalovací seznam nebo rozsahové ověření, aby vyplňovali pouze přijatelné hodnoty.

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");

Styling výstupu pro čitelnost

Použijte styly buněk — písma, barvy výplně, formáty čísel, okraje — k vytvoření vylepšeného výstupu. Vytvořte instanci Style přímo, nakonfigurujte její vlastnosti a použijte ji pomocí 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");