如何使用 C# 與 IronWord 將表格新增至 DOCX。

IronWord 可讓開發人員使用 C# 程式化地在 Word 文件中加入表格，方法是以指定的行和列建立 Table 物件，並使用邊框和顏色為其造型，以及在儲存為 DOCX 檔案前將內容填入儲存格。

<! -- --> <！--說明：說明程式碼概念的圖表或截圖 -->

快速入門：一次呼叫即可建立並儲存表格

本範例示範如何在 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` 枚舉為表格美學提供了全面的選項。 從簡單的單線到複雜的圖案（如波浪和點），每種樣式都能達到特定的設計目的。 商業文件受益於專業的 Double 或 Triple 邊框，而創意文件則利用 Wave 或 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"); ``` 表格寬度和對齊方式屬性提供額外的版面控制。 將表格設定為特定寬度或百分比，在文件中對齊表格，並控制與周遭內容的互動。 單元格層級的樣式選項包括個別背景顏色、文字對齊方式和襯墊調整，提供表格外觀各方面的細部控制。 這些樣式選項能夠建立符合任何文件設計需求的表格，從簡單的資料網格到具有多重視覺層級的複雜財務報表。 <！--工作後加入陰影造型-->。