如何使用C#的Office.Interop.Word库为Word表格插入题注

现有代码问题 #

• 执行顺序错误：题注插入代码写在了表格创建代码之前，此时oDoc.Tables[3]还未生成，属于无效对象
• 调用方法错误：Selection.InsertCaption的参数不支持直接传入表格对象，且依赖光标位置的操作稳定性极低，不推荐使用

修正后的实现代码 #

using Word = Microsoft.Office.Interop.Word;
using System.Runtime.InteropServices;

object oMissing = System.Reflection.Missing.Value;
object oEndOfDoc = "\\endofdoc"; 

//启动Word并创建文档
Word._Application oWord = new Word.Application();
oWord.Visible = true;
object oTemplate = "C:\\Users\\a_shiGenerate word document report\\acidproTemplateDocx.docx";
Word._Document oDoc = oWord.Documents.Add(ref oTemplate, ref oMissing, ref oMissing, ref oMissing);

// 先创建表格，保存表格对象引用
Word.Table targetTable = oDoc.Tables.Add(wrdRng, 5, 10, ref oMissing, ref oMissing);

// 设置表格属性
oDoc.Paragraphs.SpaceBefore = 0.0f;
oDoc.PageSetup.LeftMargin = 25.0f;
oDoc.PageSetup.RightMargin = 29.0f;
targetTable.Columns[2].Cells.PreferredWidth = 100;
targetTable.Columns[1].Cells.PreferredWidth = 100;
targetTable.Cell(1, 1).Range.Text = "hello";
targetTable.Cell(1, 2).Range.Text = "arman";
targetTable.Cell(1, 3).Range.Text = "this";
targetTable.Cell(1, 4).Range.Text = "is  Image";
targetTable.Cell(1, 1).Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;
targetTable.Cell(1, 2).Range.ParagraphFormat.Alignment = Word.WdParagraphAlignment.wdAlignParagraphCenter;
targetTable.Cell(1, 1).Range.Font.Bold = 1;
targetTable.Cell(1, 2).Range.Font.Bold = 1;
targetTable.Cell(1, 3).Range.Font.Bold = 1;
targetTable.Cell(1, 4).Range.Font.Bold = 1;
targetTable.Range.Font.Size = 10;
targetTable.Rows.Height = 2.0f;

// 添加自定义题注标签，先判重避免重复添加报错
string captionName = "表格";
if (!oWord.CaptionLabels.Cast<Word.CaptionLabel>().Any(l => l.Name == captionName))
{
    oWord.CaptionLabels.Add(captionName);
}
object captionLabel = oWord.CaptionLabels[captionName];
// 设置题注位置：上方/下方
object captionPosition = Word.WdCaptionPosition.wdCaptionPositionAbove;
object excludeLabel = false;
// 直接给目标表格插入题注，不依赖Selection
targetTable.Range.InsertCaption(ref captionLabel, ref oMissing, ref oMissing, ref captionPosition, ref excludeLabel);

Office.Interop.Word使用技巧 #

• 释放COM对象：所有操作完成后，必须依次释放Document、Application等COM对象，避免Word进程残留后台：

  Marshal.ReleaseComObject(targetTable);
  oDoc.Close();
  Marshal.ReleaseComObject(oDoc);
  oWord.Quit();
  Marshal.ReleaseComObject(oWord);
  targetTable = null;
  oDoc = null;
  oWord = null;
  

• 关闭屏幕更新：生成多页/多内容的文档时，先设置oWord.ScreenUpdating = false，生成完成后再恢复为true，可以大幅提升生成速度，避免界面闪烁
• 优先使用模板预定义样式：提前在Word模板里设置好表格、标题、正文的样式，代码中直接通过targetTable.set_Style("自定义表格样式")应用样式，不需要逐个设置字体、对齐、边框等属性，代码更简洁且格式统一
• 用书签定位内容：在模板中提前插入书签，生成内容时直接定位到书签对应的Range插入内容，比通过索引计数定位表格、段落的稳定性高很多，修改模板结构也不用调整代码索引

内容的提问来源于stack exchange，提问作者alpha wolf