如何使用 IronWord 在 DOCX 中使用 C&#35 添加表格。

IronWord 使开发人员能够通过创建具有指定行和列的 Table 对象，使用边框和颜色对其进行样式设置，并在保存为 DOCX 文件之前将内容填充到单元格中，从而以 C# 编程方式将表格添加到 Word 文档中。

<! -- 待办事项：在此处添加图片 --> <! -- --> <！--说明：说明代码概念的图表或截图 -->

快速入门：一次调用即可创建并保存表格

本示例演示了如何在 IronWord 中创建表格。 使用尺寸构建表格，应用样式，添加内容，将其插入文档并保存。 您可以在几分钟内生成带有样式表的 DOCX 文件。

如何在 Word 文档中添加表格？ 表格是 Word 文档的基本组成部分。 首先，通过提供行数和列数实例化 `Table` 类。 配置表格的样式，包括背景颜色、阴影、边框、斑马线和宽度。 其次，使用直观的 `[row, column]` 索引访问每个单元格。 在每个单元格中添加文本、图像、形状、段落甚至表格。 最后，将表格添加到 Word 文档中。 IronWord 中的表格为在 Word 文档中组织结构化数据提供了灵活的基础。 无论是创建发票、报告还是数据摘要，`Table` 类都能提供对内容和表现形式的全面控制。 零基索引系统简化了程序单元的迭代，而丰富的样式选项则确保了专业的外观。 所有行和列索引位置均采用从零开始的索引方式。 ```csharp :path=/static-assets/word/content-code-examples/how-to/add-table-add-table.cs ```

`TableCell` 类的 `AddChild` 方法接受 `ContentElement` 对象，其中包括段落、图像、形状和表格。 这使得复杂用例的嵌套表格成为可能。 在处理表格单元格时，IronWord 为内容管理提供了多种方法。 使用构造函数以初始内容实例化 `TableCell` 或使用 `AddChild` 方法逐步添加内容。 这种灵活性允许构建结合不同内容类型的复杂单元格结构。例如，单个单元格可能包含一个标题段落，然后是一张图片和一个嵌套表格，用于详细说明。 下面是一个演示高级细胞群技术的示例： ```csharp // Example: Creating cells with mixed content TableCell complexCell = new TableCell(); // Add a styled paragraph Paragraph header = new Paragraph(); header.Add(new TextContent("Product Details").Bold().FontSize = 14); complexCell.AddChild(header); // Add multiple text elements complexCell.AddChild(new TextContent("SKU: ")); complexCell.AddChild(new TextContent("PROD-001").Bold()); complexCell.AddChild(new TextContent("\nPrice: $49.99")); // Cells can also contain lists, images, and more // This demonstrates the versatility of table cells in IronWord ```

我可以对表格应用哪些样式选项？ IronWord 为表格提供了广泛的样式设计功能，可以创建视觉上吸引人的专业文档。 除了基本的边框和颜色外，还可以控制单元格填充、对齐，并通过斑马线应用条件格式。 样式系统将强大功能与直观设计相结合，使用熟悉的属性名称和清晰的值枚举。

哪些边框样式可用？ 使用 `BorderValues` 枚举探索边框值的所有可用选项：

`BorderValues` 枚举提供了全面的表格美学选项。 从简单的单线到复杂的波浪和圆点等图案，每种样式都有特定的设计目的。 商务文件受益于专业的双边框或三边框，而创意文件则利用波浪或 DashDot 模式。 `BorderSize` 属性与 `BorderValue` 配合使用，可精确控制线条粗细，单位为八分之一点。 下面是一个显示不同边框配置的实用示例： ```csharp // Example: Applying different borders to table sections Table styledTable = new Table(4, 4); // Create distinct border styles for header and body BorderStyle headerBorder = new BorderStyle { BorderColor = Color.Navy, BorderValue = BorderValues.Double, BorderSize = 8 }; BorderStyle bodyBorder = new BorderStyle { BorderColor = Color.Gray, BorderValue = BorderValues.Dotted, BorderSize = 3 }; // Apply different borders to different parts of the table // This creates visual hierarchy and improves readability styledTable.Borders = new TableBorders { TopBorder = headerBorder, BottomBorder = headerBorder, LeftBorder = bodyBorder, RightBorder = bodyBorder, InsideHorizontalBorder = bodyBorder, InsideVerticalBorder = bodyBorder }; // Zebra striping for better row distinction styledTable.Zebra = new ZebraColor("F5F5F5", "FFFFFF"); ``` 表宽和对齐属性提供了额外的布局控制。 将表格设置为特定宽度或百分比，在文档中对齐，并控制与周围内容的交互。 单元格级样式选项包括单独的背景颜色、文本对齐方式和填充调整，可对表格外观的各个方面进行细化控制。 通过这些样式选项，可以创建符合任何文档设计要求的表格，从简单的数据网格到具有多个可视化层次结构的复杂财务报表。