Brugssager for Aspose.Cells FOSS til .NET

Aspose.Cells FOSS for .NET er et rent administreret .NET-bibliotek, der læser og skriver XLSX-filer uden at kræve Microsoft Office eller nogen eksterne afhængigheder. Følgende brugsscenarier illustrerer, hvor biblioteket passer ind i virkelige .NET-applikationer.

Rapportgenerering

Generer XLSX‑rapporter programmatisk i server‑side eller batch‑applikationer. Brug Workbook, Worksheet og Cell.PutValue() til at skrive strukturerede data, og kald derefter Workbook.Save() for at producere filen.

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

Dette mønster skalerer til et vilkårligt antal rækker og kan drives af data fra en database eller API‑svar.

Behandler uploadede regneark

Læs og valider XLSX-filer, der indsendes af brugere gennem en webformular eller API-endpoint. Workbook-konstruktøren accepterer en Stream, så der ikke behøves at skrive en midlertidig fil til disken.

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

Brug LoadDiagnostics.HasRepairs til at opdage filer, der krævede strukturel reparation, og vise den information til brugerne.

Data Pipeline-udtræk

Udtræk celledata fra XLSX-eksport genereret af tredjepartssystemer og overfør værdier til en database eller en downstream‑tjeneste. Læs celleværdier via Cell.StringValue og Cell.Value ved hjælp af række‑ og kolonnekoordinater.

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

Anvend datavalidering før gemning

Tilføj dropdown- eller intervalvalideringsregler, før du leverer en XLSX-skabelon til slutbrugere, så de kun udfylder acceptable værdier.

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 af output for læsbarhed

Anvend celleformater — skrifttyper, fyldningsfarver, talformater, kanter — for at producere et poleret output. Opret en Style-instans direkte, konfigurer dens egenskaber, og anvend den med 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");