Aspose.Cells FOSS for .NET のユースケース

Aspose.Cells FOSS for .NET は、Microsoft Office や外部依存関係を必要とせずに XLSX ファイルの読み書きを行う純粋なマネージド .NET ライブラリです。以下のユースケースは、ライブラリが実際の .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 の応答からのデータで駆動できます。

アップロードされたスプレッドシートの処理

Web フォームまたは API エンドポイントを介してユーザーが送信した XLSX ファイルを読み取り、検証します。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");