如何在 .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，以对构建器即将创建的单元格和行应用格式——这两个属性充当新内容的模板，而不是对已插入单元格的事后更改。CellFormat 暴露 Borders、Shading、Width、WrapText、FitText、HorizontalMerge、VerticalMerge、VerticalAlignment、PreferredWidth，以及四个填充属性（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；这三种集合类型都支持 Add()、Insert()、Remove()、RemoveAt()、Contains() 和 IndexOf()，用于编程编辑。删除行或单元格后，调用 Table.EnsureMinimum()、Row.EnsureMinimum() 或 Cell.EnsureMinimum()，使节点保持 Word 所期望的最小有效结构——分别为一个空行、一个空单元格或一个空段落。