機能概要
機能概要
このページは Rust 用の Aspose.Cells FOSS の機能表面をマッピングします。各エリアは、あなたが出会うエントリーポイント型へのリンクを提供します。 API Reference.
ワークブックのライフサイクル
Workbook はルートオブジェクトです: Workbook::new は空のワークブックを作成し、Workbook::load_xlsx は既存のファイルを開き、save、save_xlsx、または save_with_format は SaveFormat 列挙型で制御される XLSX 出力を書き込みます。
let mut workbook = Workbook::new();
workbook.save("report.xlsx")?;
let reloaded = Workbook::load_xlsx("report.xlsx")?;セル、値、数式
セルコレクションはワークシート上の get_cells / get_cells_mut から取得します。型付きセッター (put_value_string、put_value_i32、put_value_bool、put_value_decimal、put_value_date_time) は文字列変換を回避し、put_formula_with_cached_value は数式とそのキャッシュ結果を一緒に保存します:
cells.get("F1")?.put_value_i32(10)?;
cells.get("G1")?
.put_formula_with_cached_value("=F1*2", CellValue::Number(20.0))?;チャート
チャートはシートのチャートコレクションを介してセル範囲にアンカーされ、ChartType バリアント(例: Column と Line)があります。アンカーとタイプは、ロードされたワークブックから Chart と ChartCollection を使用して読み戻すことができます。
スタイリングとレイアウト
CellStyle は Font、Fill、Borders を組み合わせます;StyleFlag は適用する側面を選択します。NumberFormat は値をレンダリングし、PageSetup は PaperSizeType と PageOrientationType を制御し、FreezePane はヘッダー行を固定します。
データ品質と構造
Validation(OperatorType 使用)、FormatCondition 条件付き書式、AutoFilter フィルタリング、ListObject 構造化テーブル(TableStyleType 付き)、DefinedName 名前付き範囲、そして WorkbookProtection / WorksheetProtection。
防御的ロード
LoadOptions は try_repair_package と try_repair_xml フラグを公開します;LoadDiagnostics はロード中に見つかった問題を報告します。API 全体にわたるエラーは、Result と CellsError を使用して処理されます。
ヒントとベストプラクティス
- スコープ
get_worksheets_mut/get_cells_mutはブロック内で借用されるため、ワークブックを後で保存できます。 - 文字列に値をフォーマットするよりも、型付きセッターを使用することを優先してください。
- 再計算前に正しい結果でファイルが開くように、数式とともにキャッシュされた値を常に提供してください。
- サードパーティのファイルを取り込む際は、
LoadOptions修復フラグを使用してください。
API Reference の概要
| クラス | 説明 |
|---|---|
Workbook | ルートオブジェクト: XLSX ワークブックの作成、読み込み、保存 |
Worksheet | 単一シートとそのセル、チャート、設定 |
CellMut | 可変セル: 型付き値および数式のセッター |
CellStyle | フォント、塗りつぶし、枠線によるセル書式設定 |
ChartType | チャートを追加する際のチャートタイプ選択 |
Validation | データ検証ルール |
AutoFilter | 範囲フィルタリング |
LoadOptions | ロード動作と修復フラグ |
CellsError | エラータイプが API 全体にわたって返される |