Сценарии использования 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, созданных сторонними системами, и передавайте значения в базу данных или последующий сервис. Читайте значения ячеек с помощью 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");