.NET でテーブルを操作する方法

ステップ1: パッケージをインストールする

Aspose.Words FOSS for .NET はまだ NuGet パッケージを公開していません – 代わりにソースからライブラリをビルドしてください。https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git をクローンし、.NET SDK を使用して Release 設定で Aspose.Words.sln をビルドし、生成された Aspose.Words アセンブリをプロジェクトから参照します。このライブラリは .NET Standard 2.0 をターゲットにしているため、.NET Framework 4.6.2 以上および .NET 6/8/10 で動作します。

ステップ2: 必要なクラスをインポートする

コアドキュメントクラス（Document、DocumentBuilder）のために using Aspose.Words; ディレクティブを追加し、このガイドで取り上げるテーブル固有クラスのために using Aspose.Words.Tables; ディレクティブを追加します – Table、Row、Cell、CellFormat、RowFormat、PreferredWidth、および関連する列挙型。

ステップ 3: DocumentBuilder を使用して新しいテーブルを作成する

Document とそれにバインドされた DocumentBuilder を作成し、次に DocumentBuilder.StartTable() を呼び出してカーソル位置でテーブルを開始します。行内の各セルについては DocumentBuilder.InsertCell() を呼び出し、DocumentBuilder.EndRow() で行を閉じます。テーブルが必要とする行数だけ繰り返し、全体のテーブルは DocumentBuilder.EndTable() で閉じます。すべての StartTable() には対応する EndTable() が必要であり、すべての行には対応する EndRow() が必要です。そうしないと、ビルダーの内部状態と生成されたドキュメントツリーが不正な構造になります。

ステップ 4: ビルドしながらセルと行をフォーマットする

ビルダーが作成しようとしているセルや行にフォーマットを適用するには、InsertCell() または EndRow() を呼び出す前に DocumentBuilder.CellFormat と DocumentBuilder.RowFormat を設定します――これら 2 つのプロパティは新しいコンテンツのテンプレートとして機能し、すでに挿入されたセルに遡って変更を加えるものではありません。CellFormat は Borders, Shading, Width, WrapText, FitText, HorizontalMerge, VerticalMerge, VerticalAlignment, PreferredWidth と、4 つのパディングプロパティ（LeftPadding, RightPadding, TopPadding, BottomPadding）を公開し、これらはすべて SetPaddings() で一括設定できます。RowFormat は Borders, Height, HeightRule, AllowBreakAcrossPages, HeadingFormat を公開します。次の行またはセルの新しい値を設定する前に、CellFormat.ClearFormatting() または RowFormat.ClearFormatting() を呼び出してそれぞれをデフォルトにリセットしてください。

ステップ 5: テーブル全体のレイアウトと AutoFit を設定する

テーブルが作成されたら、Table オブジェクトに対してレイアウトプロパティを直接設定します: Alignment（TableAlignment）、Bidi、LeftIndent、PreferredWidth、Style、StyleIdentifier、StyleName、StyleOptions（TableStyleOptions）、および TextWrapping。Table.SetBorders() を呼び出すと、テーブル全体に同一のボーダースタイル、幅、色を適用できます。あるいは Table.SetBorder() で単一側だけを設定し、ClearBorders() と ClearShading() でそれらをリセットします。Table.AutoFit(AutoFitBehavior) は選択された動作に従ってテーブルとセルのサイズを変更します――構造的な編集を行った後は再度呼び出してください。このメソッドは実行時点のテーブル状態のみを反映し、継続的に適用されるわけではありません。

ステップ 6: 推奨幅とセル幅を設定する

利用可能なページ幅に合わせてレイアウトが適応する幅を作成するには静的ファクトリメソッド PreferredWidth.FromPercent() を、固定幅の場合は PreferredWidth.FromPoints() を使用します。PreferredWidthType は、特定の PreferredWidth が保持している値の種類（Auto、Percent、または Points）を報告します。結果はテーブル全体の場合は Table.PreferredWidth に、単一セルの場合は CellFormat.PreferredWidth に割り当てます。

ステップ 7: セルの結合

セルを結合されたものとしてマークするには、結合に参加させるセルに CellFormat.HorizontalMerge または CellFormat.VerticalMerge（どちらも CellMerge と入力）を設定します。セルの幅を合わせるだけで見た目上結合された場合は、明示的にフラグが付いていないため、Table.ConvertToHorizontallyMergedCells() を呼び出してその視覚的配置を実際の CellMerge 状態のセルに変換します。CellVerticalAlignment は、結合の有無に関わらず、セル内のコンテンツの垂直方向の配置方法を制御します。

ステップ 8: 既存ドキュメントからテーブルを読み取る

ロード済みのドキュメントに既に存在するテーブルを操作するには、新規に作成する代わりに Body.Tables（または他の任意の Story 上の Tables プロパティ）— TableCollection — を読み取ります。Table.Rows は RowCollection を返し、Row.Cells は CellCollection を返します；これら 3 つのコレクション型はすべて、プログラムによる編集のために Add()、Insert()、Remove()、RemoveAt()、Contains()、および IndexOf() をサポートします。行やセルを削除した後は、Table.EnsureMinimum()、Row.EnsureMinimum()、または Cell.EnsureMinimum() を呼び出して、ノードが Word が期待する最小の有効構造（空の行、空のセル、または空の段落）を保つようにします。