C#代码实现设置Word表格的列宽

设置 Word 表格的列宽对于提升文档的可读性和整体美观度至关重要。合理的列宽能够避免文本过长导致阅读困难，尤其是在内容较多的表格中。Word 提供了两种常见的列宽设置方式：按百分比设置和按固定值设置。

使用百分比设置列宽时，表格能够根据页面或窗口大小自动调整布局，使内容保持整齐排列，从而提升阅读体验。而使用固定值设置列宽，则可以更精确地控制表格结构，确保版式一致性和专业性，特别适用于对数据对齐要求较高或布局较为复杂的文档。

本文将介绍如何在 C# 项目中设置 Word 表格的列宽。

准备开发环境

在开始之前，您需要在 .NET 项目中添加用于操作 Word 文档的相关库。您可以通过下载 DLL 文件并添加引用，或直接使用 NuGet 进行安装。

PM> Install-Package Spire.Doc

在 C# 中按百分比设置 Word 表格列宽

在 Word 表格中使用百分比设置列宽时，首先需要将表格的首选宽度类型设置为百分比。例如，可以通过 Table.PreferredWidth = new PreferredWidth(WidthType.Percentage, (short)100) 将表格宽度设置为页面宽度的 100%。随后，遍历表格中的各列，并根据需要为其设置相同或不同的百分比宽度。

具体步骤如下：

1. 创建一个 Document 对象。
2. 使用 Document.LoadFromFile() 方法加载 Word 文档。
3. 通过 Document.Sections[0] 获取文档中的第一个节。
4. 通过 Section.Tables[0] 获取该节中的第一个表格。
5. 使用 for 循环遍历表格中的所有行。
6. 使用 TableRow.Cells[index].SetCellWidth(value, CellWidthType.Percentage) 方法为不同列中的单元格设置百分比列宽。
7. 使用 Document.SaveToFile() 方法保存修改后的 Word 文档。

完整示例代码如下：

using Spire.Doc;

namespace SpireDocDemo
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 创建一个新的 Document 对象
            Document doc = new Document();

            // 加载名为“Sample.docx”的文档
            doc.LoadFromFile("Sample.docx");

            // 获取文档中的第一个节
            Section section = doc.Sections[0];

            // 获取该节中的第一个表格
            Table table = (Table)section.Tables[0];

            // 创建 PreferredWidth 对象，将宽度类型设置为百分比，并将宽度值设置为 100%
            PreferredWidth percentageWidth = new PreferredWidth(WidthType.Percentage, (short)100);

            // 将表格的首选宽度设置为上述 PreferredWidth 对象
            table.PreferredWidth = percentageWidth;

            // 定义一个 TableRow 类型变量
            TableRow tableRow;

            // 遍历表格中的所有行
            for (int i = 0; i < table.Rows.Count; i++)
            {
                // 获取当前行
                tableRow = table.Rows[i];

                // 将第一列单元格宽度设置为 34%，宽度类型为百分比
                tableRow.Cells[0].SetCellWidth(34, CellWidthType.Percentage);

                // 将第二列单元格宽度设置为 33%，宽度类型为百分比
                tableRow.Cells[1].SetCellWidth(33, CellWidthType.Percentage);

                // 将第三列单元格宽度设置为 33%，宽度类型为百分比
                tableRow.Cells[2].SetCellWidth(33, CellWidthType.Percentage);
            }

            // 保存修改后的文档，并指定文件格式为 Docx2016
            doc.SaveToFile("set_column_width_by_percentage.docx", FileFormat.Docx2016);

            // 关闭文档
            doc.Close();
        }
    }
}

在 C# 中按固定值设置 Word 表格列宽

在 Word 表格中使用固定值设置列宽时，首先需要将表格布局设置为固定模式，即通过 Table.TableFormat.LayoutType = LayoutType.Fixed 进行设置。随后，遍历表格中的各列，并根据需要为其设置相同或不同的固定宽度值。

具体步骤如下：

1. 创建一个 Document 对象。
2. 使用 Document.LoadFromFile() 方法加载 Word 文档。
3. 通过 Document.Sections[0] 获取文档中的第一个节。
4. 通过 Section.Tables[0] 获取该节中的第一个表格。
5. 使用 for 循环遍历表格中的所有行。
6. 使用 TableRow.Cells[index].SetCellWidth(value, CellWidthType.Point) 方法为不同列中的单元格设置固定列宽。其中，value 需要替换为所需的宽度值（单位为磅）。
7. 使用 Document.SaveToFile() 方法保存修改后的 Word 文档。

完整示例代码如下：

using Spire.Doc;

namespace SpireDocDemo
{
    internal class Program
    {
        static void Main(string[] args)
        {
            // 创建一个新的 Document 对象
            Document doc = new Document();

            // 加载文档
            doc.LoadFromFile("Sample.docx");

            // 获取文档中的第一个节
            Section section = doc.Sections[0];

            // 获取该节中的第一个表格
            Table table = (Table)section.Tables[0];

            // 将表格布局类型设置为固定
            table.Format.LayoutType = LayoutType.Fixed;

            // 获取左边距
            float leftMargin = section.PageSetup.Margins.Left;

            // 获取右边距
            float rightMargin = section.PageSetup.Margins.Right;

            // 计算页面宽度（减去左右边距）
            double pageWidth = section.PageSetup.PageSize.Width - leftMargin - rightMargin;

            // 定义一个 TableRow 类型变量
            TableRow tableRow;

            // 遍历表格中的所有行
            for (int i = 0; i < table.Rows.Count; i++)
            {
                // 获取当前行
                tableRow = table.Rows[i];

                // 将第一列单元格宽度设置为页面宽度的 34%
                tableRow.Cells[0].SetCellWidth((float)(pageWidth * 0.34), CellWidthType.Point);

                // 将第二列单元格宽度设置为页面宽度的 33%
                tableRow.Cells[1].SetCellWidth((float)(pageWidth * 0.33), CellWidthType.Point);

                // 将第三列单元格宽度设置为页面宽度的 33%
                tableRow.Cells[2].SetCellWidth((float)(pageWidth * 0.33), CellWidthType.Point);
            }

            // 保存修改后的文档，并指定文件格式为 Docx2016
            doc.SaveToFile("set_column_width_to_fixed_value.docx", FileFormat.Docx2016);

            // 关闭文档
            doc.Close();
        }
    }
}

知识扩展

在 C# 中设置 Word 表格列宽，根据使用的库不同，实现方式也有所差异。Spire.Doc 通过遍历行设置单元格宽度，Open XML SDK 操作 GridColumn 元素，Aspose.Words 则提供了 PreferredWidth 属性。

方案一：使用 Spire.Doc for .NET

Spire.Doc 是操作 Word 文档的主流商业库之一，无需安装 Microsoft Office 即可在 .NET 环境下高效处理 Word 文档。

安装：

PM> Install-Package Spire.Doc

示例代码：设置指定列的宽度

using Spire.Doc;
using Spire.Doc.Documents;
// 1. 加载文档
Document doc = new Document();
doc.LoadFromFile("Sample.docx");
// 2. 获取第一个表格
Table table = (Table)doc.Sections[0].Tables[0];
// 3. 设置表格首选宽度为 100%（百分比模式）
table.PreferredWidth = new PreferredWidth(WidthType.Percentage, (short)100);
// 4. 遍历所有行，设置列宽[reference:5]
for (int i = 0; i < table.Rows.Count; i++)
{
    // 第一列：固定宽度 200 磅（Point）
    table.Rows[i].Cells[0].SetCellWidth(200, CellWidthType.Point);
    // 第二列：宽度为表格宽度的 50%（百分比）
    table.Rows[i].Cells[1].SetCellWidth(50, CellWidthType.Percentage);
    // 第三列：固定宽度 150 磅
    table.Rows[i].Cells[2].SetCellWidth(150, CellWidthType.Point);
}
// 5. 保存文档
doc.SaveToFile("Result.docx", FileFormat.Docx);

注意：Spire.Doc 没有直接设置列宽的方法，需要遍历表格的每一行，通过设置该行中对应单元格的宽度来实现列宽控制。

方案二：使用 Open XML SDK（官方免费，适合服务端）

Open XML SDK 是微软官方提供的库，无需安装 Office，适合在服务端进行批量文档处理。

安装：

PM> Install-Package DocumentFormat.OpenXml

示例代码：操作 TableGrid 的 GridColumn

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Wordprocessing;
using (WordprocessingDocument doc = WordprocessingDocument.Open("Sample.docx", true))
{
    // 获取文档主体中的第一个表格
    Table table = doc.MainDocumentPart.Document.Body.Descendants<Table>().First();
    // 获取或创建表格网格（TableGrid）
    TableGrid tableGrid = table.GetFirstChild<TableGrid>();
    if (tableGrid == null)
    {
        tableGrid = new TableGrid();
        table.InsertAt(tableGrid, 0);
    }
    // 清空现有网格列
    tableGrid.RemoveAllChildren();
    // 定义各列宽度（单位：缇，1 磅 = 20 缇）
    int[] columnWidthsInTwips = new int[] { 4000, 2000, 3000 }; // 分别对应 200、100、150 磅
    foreach (int width in columnWidthsInTwips)
    {
        tableGrid.AppendChild(new GridColumn() { Width = width.ToString() });
    }
    doc.Save();
}

方案三：使用 Aspose.Words for .NET

Aspose.Words 是功能全面的商业 Word 操作库，提供了更丰富的表格格式化能力。

安装：

PM> Install-Package Aspose.Words

示例代码：设置单元格的首选宽度

using Aspose.Words;
using Aspose.Words.Tables;
Document doc = new Document("Sample.docx");
Table table = (Table)doc.GetChild(NodeType.Table, 0, true);
// 遍历每一行，设置列宽[reference:15]
foreach (Row row in table.Rows)
{
    // 第一列：固定宽度 200 磅
    row.Cells[0].CellFormat.PreferredWidth = PreferredWidth.FromPoints(200);
    // 第二列：宽度为表格宽度的 50%
    row.Cells[1].CellFormat.PreferredWidth = PreferredWidth.FromPercent(50);
    // 第三列：固定宽度 150 磅
    row.Cells[2].CellFormat.PreferredWidth = PreferredWidth.FromPoints(150);
}
doc.Save("Result.docx");

方案四：使用 Microsoft.Office.Interop.Word（需安装 Word）

此方案依赖本地安装的 Microsoft Office Word，适合 Windows 桌面端应用。

using Microsoft.Office.Interop.Word;
Application wordApp = new Application();
Document doc = wordApp.Documents.Open(@"C:\Sample.docx");
// 获取第一个表格
Table table = doc.Tables[1];
// 设置第一列宽度为 200 磅[reference:19]
table.Columns[1].SetWidth(200, WdRulerStyle.wdAdjustNone);
// 设置第二列宽度为 100 磅
table.Columns[2].SetWidth(100, WdRulerStyle.wdAdjustNone);
doc.Save();
doc.Close();
wordApp.Quit();