Aspose.Cells FOSS for .NET:n käyttötapaukset

Aspose.Cells FOSS for .NET on puhdas hallinnoitu .NET‑kirjasto, joka lukee ja kirjoittaa XLSX‑tiedostoja ilman Microsoft Officen tai muiden ulkoisten riippuvuuksien tarvetta. Seuraavat käyttötapaukset havainnollistavat, missä kirjasto sopii todellisissa .NET‑sovelluksissa.

Raportin luominen

Luo XLSX-raportteja ohjelmallisesti palvelinpuolen tai eräajojen sovelluksissa. Käytä Workbook, Worksheet ja Cell.PutValue() kirjoittaaksesi rakenteellista dataa, ja kutsu sitten Workbook.Save() tiedoston tuottamiseksi.

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

Tämä malli skaalautuu mihin tahansa rivimäärään ja sitä voidaan ohjata tietokannasta tai API‑vastauksesta tulevilla tiedoilla.

Ladattujen taulukoiden käsittely

Lue ja validoi käyttäjien lähettämät XLSX‑tiedostot verkkolomakkeen tai API‑päätepisteen kautta. Workbook‑konstruktori hyväksyy Stream, joten väliaikaista tiedostoa ei tarvitse kirjoittaa levylle.

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

Käytä LoadDiagnostics.HasRepairs havaitsemaan tiedostot, jotka vaativat rakenteellista korjausta, ja esitä tämä tieto käyttäjille.

Dataputken poiminta

Poimi solutiedot kolmannen osapuolen järjestelmien tuottamista XLSX-viennistä ja syötä arvot tietokantaan tai alavirtaiseen palveluun. Lue soluarvot Cell.StringValue ja Cell.Value käyttäen rivin ja sarakkeen koordinaatteja.

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

Tietojen validoinnin soveltaminen ennen tallennusta

Lisää avattavan valikon tai alueen validointisäännöt ennen XLSX-mallipohjan toimittamista loppukäyttäjille, varmistaen että he täyttävät vain hyväksyttävät arvot.

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

Tulosteen tyylittely luettavuuden parantamiseksi

Käytä solutyylejä — fontteja, täyttövärejä, numeroformaatteja, reunuksia — tuottaaksesi viimeistellyn tulosteen. Luo Style-instanssi suoraan, määritä sen ominaisuudet ja sovella sitä Cell.SetStyle():lla.

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