如何使用 OpenXml SDK 2.0 更改 Word 2007 中内容控件的内容？

Question

快要被这个问题搞疯了。我确信它是如此简单，我只是想念它，但我一生都无法找出如何使用 C# 中的 OpenXml SDK v2.0 更改 Word 2007 中的内容控件的内容。

我创建了一个带有纯文本内容控件的 Word 文档。该控件的标签是“FirstName”。在代码中，我想打开Word文档，找到此内容控件，然后更改内容而不丢失格式。

我最终找到的解决方案涉及找到内容控件，在其后面插入一个运行，然后删除内容控件，如下所示：

using (WordprocessingDocument wordProcessingDocument = WordprocessingDocument.Open(filePath, true)) {
MainDocumentPart mainDocumentPart = wordProcessingDocument.MainDocumentPart;
SdtRun sdtRun = mainDocumentPart.Document.Descendants<SdtRun>()
 .Where(run => run.SdtProperties.GetFirstChild<Tag>().Val == "FirstName").Single();

if (sdtRun != null) {
 sdtRun.Parent.InsertAfter(new Run(new Text("John")), sdtRun);
 sdtRun.Remove();
}

这确实更改了文本，但我丢失了所有格式。有谁知道我该怎么做？

Answer 1

我找到了一种更好的方法来使用 http:// /wiki. Threewill.com/display/enterprise/SharePoint+and+Open+XML#SharePointandOpenXML-UsingWord2007ContentControls 作为参考。您的结果可能会有所不同，但我认为这会给您一个良好的开端：

using (WordprocessingDocument wordprocessingDocument = WordprocessingDocument.Open(filePath, true)) {
    var sdtRuns = mainDocumentPart.Document.Descendants<SdtRun>()
        .Where(run => run.SdtProperties.GetFirstChild<Tag>().Val.Value == contentControlTagValue);

    foreach (SdtRun sdtRun in sdtRuns) {
        sdtRun.Descendants<Text>().First().Text = replacementText;
    }

    wordprocessingDocument.MainDocumentPart.Document.Save();
}

我认为上述内容仅适用于纯文本内容控件。不幸的是，它并没有摆脱最终文档中的内容控制。如果我能做到这一点，我会发布它。

http://msdn.microsoft.com/en-us/library/cc197932.aspx如果您想找到富文本内容控件，也是一个很好的参考。本节讨论向放置在富文本内容控件中的表添加行。

Answer 2

删除 sdtRun 并添加新的第一种方法显然会删除格式，因为您只添加 Run 而不是 RunStyle。要保留格式，您应该创建 run 元素，例如

new Run( new RunProperties(new RunStyle(){ Val = "MyStyle" }),
                            new Text("Replacement Text"));

您的第二种替换所有后代的方法仅适用于纯文本内容控件，因为富文本内容控件没有 SdtRun 元素。富文本内容控件是带有 SdtContent 元素的 SdtBlock。富文本内容控件可以具有多个段落、多个运行和多个文本。因此，您的代码 sdtRun.Descendants().First().Text = replacementText 对于富文本内容控件来说将存在缺陷。没有一行代码可以替换丰富内容控件的整个文本，同时保留所有格式。

我不明白你所说的“它没有摆脱最终文档中的内容控制”是什么意思？我认为您的要求是仅通过保留内容控件和格式来更改文本（内容）。

Answer 3

实现所需结果的一种绝佳方法是使用 Open XML SDK 2.0 附带的文档反射器工具...

例如，您可以：

1. 在文档中每个内容控件的“属性”对话框中，勾选“编辑内容时移除内容控制”。
2. 填写它们并将其另存为新文档。
3. 使用反射器比较原始版本和保存的版本。
4. 点击显示/隐藏代码按钮，它将显示将原始版本转换为填充版本所需的代码。

它并不完美，但非常有用。您还可以直接查看任一文档的标记，并查看填充控件所引起的更改。

这是一种有点脆弱的方法，因为字处理 ML 可能很复杂；很容易搞砸。对于简单的文本控件，我只使用这种方法：

private void FillSimpleTextCC(SdtRun simpleTextCC, string replacementText)
    {
        // remove the showing place holder element      
        SdtProperties ccProperties = simpleTextCC.SdtProperties;
        ccProperties.RemoveAllChildren<ShowingPlaceholder>();

        // fetch content block Run element            
        SdtContentRun contentRun = simpleTextCC.SdtContentRun;
        var ccRun = contentRun.GetFirstChild<Run>();

        // if there was no placeholder text in the content control, then the SdtContentRun
        // block will be empty -> ccRun will be null, so create a new instance
        if (ccRun == null)
        {
            ccRun = new Run(
                new RunProperties() { RunStyle = null },
                new Text());
            contentRun.Append(ccRun);
        }

        // remove revision identifier & replace text
        ccRun.RsidRunProperties = null;
        ccRun.GetFirstChild<Text>().Text = replacementText;

        // set the run style to that stored in the SdtProperties block, if there was
        // one. Otherwise the existing style will be used.            
        var props = ccProperties.GetFirstChild<RunProperties>();
        if (props != null)
        if (props != null)
        {
            RunStyle runStyle = props.RunStyle;
            if (runStyle != null)
            {
                // set the run style to the same as content block property style.
                var runProps = ccRun.RunProperties;
                runProps.RunStyle = new RunStyle() { Val = runStyle.Val };
                runProps.RunFonts = null;
            }
        }
    }

希望能以某种方式有所帮助。 ：D

Answer 4

我还必须查找并替换页脚中的文本。您可以使用以下代码找到它们：

using (WordprocessingDocument wordprocessingDocument = WordprocessingDocument.Open(file.PhysicalFile.FullName, true)) {
    foreach (FooterPart footerPart in wordprocessingDocument.MainDocumentPart.FooterParts) {
        var footerPartSdtRuns = footerPart.Footer.Descendants<SdtRun>()
            .Where(run => run.SdtProperties.GetFirstChild<Tag>().Val.Value == contentControlTag);

        foreach (SdtRun sdtRun in footerPartSdtRuns) {
           sdtRun.Descendants<Text>().First().Text = replacementTerm;
        }
    }

    wordprocessingDocument.MainDocumentPart.Document.Save();
}

Answer 5

另一种解决方案是

        SdtRun rOld = p.Elements<SdtRun>().First();

        string OldNodeXML = rOld.OuterXml;
        string NewNodeXML = OldNodeXML.Replace("SearchString", "ReplacementString");

        SdtRun rNew = new SdtRun(NewNodeXML);


        p.ReplaceChild<SdtRun>(rNew, rOld);

Answer 6

内容控件类型

根据 Word 文档中的插入点，创建两种类型的内容控件：

• 顶级（与段落处于同一级别）

• 嵌套（通常在现有段落内）

令人困惑的是，在 XML 中，两种类型都被标记为 ... 但底层的 openXML 类不同。
对于顶层，根为 SdtBlock，内容为 SdtContentBlock。对于嵌套，它是 SdtRun & SdtContentRun。

要获取这两种类型，即所有内容控件，最好通过公共基类 SdtElement 进行迭代，然后检查类型：

List<SdtElement> sdtList = document.Descendants<SdtElement>().ToList();

foreach( SdtElement sdt in sdtList )
{
   if( sdt is SdtRun )
   {
      ; // process nested sdts
   }

   if( sdt is SdtBlock )
   {
      ; // process top-level sdts
   }
}

对于文档模板，应处理所有内容控件 -多个内容控件具有相同的标签名称（例如客户名称）是很常见的，所有这些通常都需要替换为实际的客户名称。

内容控制标记名称

内容控制标记名称永远不会被拆分。

在 XML 中，这是：

<w:sdt>
...
<w:sdtPr>
...
<w:tag w:val="customer-name"/>

因为标记名称永远不会被分割，所以总是可以通过直接匹配找到它：

   List<SdtElement> sdtList = document.Descendants<SdtElement>().ToList();
        
   foreach( SdtElement sdt in sdtList )
   {
       if( sdt is SdtRun )
       {
         String tagName = sdt.SdtProperties.GetFirstChild<Tag>().Val;

         if( tagName == "customer-name" )
         {
            ; // get & replace placeholder with actual value
         }

显然，在上面的代码中，需要有一个更优雅的机制来检索与每个标记对应的实际值不同的标签名称。

内容控制文本

在内容控件中，将呈现的文本分为多个运行（尽管每个运行具有相同的属性）是很常见的。

除其他外，这是由拼写/语法检查器和语法检查器引起的。编辑尝试的次数。
当使用分隔符时，文本分割更为常见，例如 [customer-name] 等。

这很重要的原因是，如果不检查 XML，就不可能保证占位符文本没有被分割，因此无法找到它并更换。

一种建议的方法

一种建议的方法是仅使用纯文本内容控件、顶级和/或嵌套，然后：

• 通过标记名称查找内容控件

• 在内容控件后插入格式化段落或运行

• 删除内容控件

   列表 sdtList = document.Descendants().ToList();
  
   foreach( sdtList 中的 SdtElement sdt )
   {
      if( sdt 是 SdtRun )
      {
         String tagName = sdt.SdtProperties.GetFirstChild().Val;
  
         String newText = "新文本"; // 例如 GetTextByTag( tagName );
  
         // 应该使用样式或常见的 run props
  
         RunProperties runProps = new RunProperties();
  
         runProps.Color = new Color() { Val = "000000" };
         runProps.FontSize = new FontSize() { Val = "23" };
         runProps.RunFonts = new RunFonts() { Ascii = "Calibri" };
  
         运行运行=新的运行();
  
         run.Append( runProps );
         运行.Append( 新文本( newText ) );
  
         sdt.InsertAfterSelf( 运行 );
  
         sdt.Remove();
      }
  
      if( sdt 是 SdtBlock )
      {
         ; // 添加段落
      }
   }
  

对于顶级类型，需要插入一个段落。

在这种方法中，内容控件仅用作占位符，可以保证找到（通过标记名称），然后完全替换为适当的文本（格式一致）。

此外，这还消除了格式化内容控制文本的需要（该文本可能会被分割，因此无法找到）。

对标签名称使用合适的命名约定，例如 Xpath 表达式，可以实现更多的可能性，例如使用其他 XML 文档来填充模板。