מקרי שימוש עבור Aspose.Cells FOSS עבור .NET

Aspose.Cells FOSS for .NET היא ספרייה מנוהלת טהורה ב‑.NET הקוראת וכותבת קבצי XLSX ללא צורך ב‑Microsoft Office או בתלות חיצונית כלשהי. המקרים הבאים מדגימים היכן שהספרייה מתאימה ליישומי .NET בעולם האמיתי.

יצירת דוח

צור דוחות XLSX באופן תכנותי ביישומי צד‑שרת או באצ’ . השתמש בWorkbook, Worksheet וCell.PutValue() כדי לכתוב נתונים מובנים, ואז קרא לWorkbook.Save() כדי לייצר את הקובץ.

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

תבנית זו ניתנת להרחבה לכל מספר של שורות וניתן להניע אותה באמצעות נתונים ממסד נתונים או תגובת API.

עיבוד גיליונות אלקטרוניים שהועלו

קרא ואמת קבצי XLSX שהוגשו על ידי משתמשים דרך טופס אינטרנט או נקודת קצה של API. הבונה Workbook מקבל Stream, ולכן אין צורך לכתוב קובץ זמני לדיסק.

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

השתמש בLoadDiagnostics.HasRepairs כדי לאתר קבצים שדרשו תיקון מבני ולהציג מידע זה למשתמשים.

חילוץ צינור נתונים

חלץ נתוני תאים מייצוא XLSX שנוצר על ידי מערכות צד שלישי והזין ערכים למסד נתונים או לשירות downstream. קרא ערכי תאים באמצעות Cell.StringValue ו-Cell.Value באמצעות קואורדינטות שורה ועמודה.

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

החלת אימות נתונים לפני שמירה

הוסף רשימות נפתחות או כללי אימות של טווח לפני מסירת תבנית XLSX למשתמשי הקצה, כדי להבטיח שהם ימלאו רק ערכים מקובלים.

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

עיצוב הפלט לקריאות

החל סגנונות תאים — גופנים, צבעי מילוי, פורמטים מספריים, גבולות — כדי ליצור פלט מלוטש. צור מופע Style ישירות, הגדר את המאפיינים שלו והחל אותו עם 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");