简体   繁体   English

使用 OpenXml 和 C# 复制 Word 文档

[英]Duplicating Word document using OpenXml and C#

I am using Word and OpenXml to provide mail merge functionality in a C# ASP.NET web application:我正在使用 Word 和 OpenXml 在 C# ASP.NET Web 应用程序中提供邮件合并功能:

1) A document is uploaded with a number of pre-defined strings for substitution. 1) 上传的文档带有多个预定义的字符串进行替换。

2) Using the OpenXML SDK 2.0 I open the Word document, get the mainDocumentPart as a string and perform the substitution using Regex. 2) 使用 OpenXML SDK 2.0 我打开 Word 文档,获取 mainDocumentPart 作为字符串并使用 Regex 执行替换。

3) I then create a new document using OpenXML, add a new mainDocumentPart and insert the string resulting from the substitution into this mainDocumentPart. 3) 然后我使用 OpenXML 创建一个新文档,添加一个新的 mainDocumentPart 并将替换产生的字符串插入到这个 mainDocumentPart 中。

However, all formatting/styles etc. are lost in the new document.但是,所有格式/样式等都将在新文档中丢失。

I'm guessing I can copy and add the Style, Definitions, Comment parts etc.. individually to mimic the orginal document.我猜我可以单独复制和添加样式、定义、注释部分等来模仿原始文档。

However is there a method using Open XML to duplicate a document allowing me to perform the substitutions on the new copy?但是,是否有使用 Open XML 复制文档的方法,允许我对新副本执行替换?

Thanks.谢谢。

This piece of code should copy all parts from an existing document to a new one.这段代码应该将现有文档中的所有部分复制到新文档中。

using (var mainDoc = WordprocessingDocument.Open(@"c:\sourcedoc.docx", false))
using (var resultDoc = WordprocessingDocument.Create(@"c:\newdoc.docx",
  WordprocessingDocumentType.Document))
{
  // copy parts from source document to new document
  foreach (var part in mainDoc.Parts)
    resultDoc.AddPart(part.OpenXmlPart, part.RelationshipId);
  // perform replacements in resultDoc.MainDocumentPart
  // ...
}

I second the use of Content Controls recommendation.我第二次推荐使用 Content Controls。 Using them to mark up the areas of your document where you want to perform substitution is by far the easiest way to do it.使用它们来标记要执行替换的文档区域是迄今为止最简单的方法。

As for duplicating the document (and retaining the entire document contents, styles and all) it's relatively easy:至于复制文档(并保留整个文档内容、样式等)相对容易:

string documentURL = "full URL to your document";
byte[] docAsArray = File.ReadAllBytes(documentURL);

using (MemoryStream stream = new MemoryStream)
{
    stream.Write(docAsArray, 0, docAsArray.Length);    // THIS performs doc copy
    using (WordprocessingDocument doc = WordprocessingDocument.Open(stream, true))
    {
        // perform content control substitution here, making sure to call .Save()
        // on any documents Part's changed.
    }
    File.WriteAllBytes("full URL of your new doc to save, including .docx", stream.ToArray());
}

Actually finding the content controls is a piece of cake using LINQ.实际上使用 LINQ 找到内容控件是小菜一碟。 The following example finds all the Simple Text content controls (which are typed as SdtRun):以下示例查找所有简单文本内容控件(类型为 SdtRun):

using (WordprocessingDocument doc = WordprocessingDocument.Open(stream, true))
{                    
    var mainDocument = doc.MainDocumentPart.Document;
    var contentControls = from sdt in mainDocument.Descendants<SdtRun>() select sdt;

    foreach (var cc in contentControls)
    {
        // drill down through the containment hierarchy to get to 
        // the contained <Text> object
        cc.SdtContentRun.GetFirstChild<Run>().GetFirstChild<Text>().Text = "my replacement string";
    }
}

The <Run> and <Text> elements may not already exist but creating them is a simple as: <Run><Text>元素可能不存在,但创建它们很简单:

cc.SdtContentRun.Append(new Run(new Text("my replacement string")));

Hope that helps someone.希望能帮助某人。 :D :D

I have done some very similar things, but instead of using text substitution strings, I use Word Content Controls.我做了一些非常相似的事情,但我没有使用文本替换字符串,而是使用 Word 内容控件。 I have documented some of the details in the following blog post, SharePoint and Open Xml .我在以下博客文章SharePoint 和 Open Xml 中记录了一些详细信息。 The technique is not specific to SharePoint.该技术并非特定于 SharePoint。 You could reuse the pattern in pure ASP.NET or other applications.您可以在纯 ASP.NET 或其他应用程序中重用该模式。

Also, I would STRONGLY encourage you to review Eric White's Blog for tips, tricks and techniques regarding Open Xml.此外,我强烈建议您查看Eric White 的博客,了解有关 Open Xml 的提示、技巧和技术。 Specifically, check out the in-memory manipulation of Open Xml post , and the Word content controls posts.具体来说,查看Open Xml post 的内存操作,以及Word 内容控制帖子。 I think you'll find these much more helpful in the long run.我认为从长远来看,你会发现这些更有帮助。

Hope this helps.希望这可以帮助。

As an addenda to the above;作为上述内容的补充; what's perhaps more useful is finding content controls that have been tagged (using the word GUI).可能更有用的是查找已标记的内容控件(使用 GUI 一词)。 I recently wrote some software that populated document templates that contained content controls with tags attached.我最近编写了一些软件来填充包含带有附加标签的内容控件的文档模板。 To find them is just an extension of the above LINQ query:找到它们只是上述 LINQ 查询的扩展:

var mainDocument = doc.MainDocumentPart.Document;
var taggedContentControls = from sdt in mainDocument.Descendants<SdtElement>()
                            let sdtPr = sdt.GetFirstChild<SdtProperties>()
                            let tag = (sdtPr == null ? null : sdtPr.GetFirstChild<Tag>())
                            where (tag != null)
                            select new
                            {
                                SdtElem = sdt,
                                TagName = tag.GetAttribute("val", W).Value
                            };   

I got this code from elsewhere but cannot remember where at the moment;我从别处得到了这个代码,但现在不记得在哪里; full credit goes to them.完全归功于他们。

The query just creates an IEnumerable of an anonymous type that contains the content control and its associated tag as properties.该查询只是创建一个匿名类型的 IEnumerable,其中包含内容控件及其关联的标记作为属性。 Handy!便利!

The original question was asked before a number of helpful features were added to the Open XML SDK.最初的问题是在向 Open XML SDK 添加许多有用功能之前提出的。 Nowadays, if you already have an opened WordprocessingDocument , you would simply clone the original document and perform whatever transformation on that clone.如今,如果您已经有一个打开的WordprocessingDocument ,您只需克隆原始文档并对该克隆执行任何转换。

// Say you have done this somewhere before you want to duplicate your document.
using WordprocessingDocument originalDoc = WordprocessingDocument.Open("original.docx", false);

// Then this is how you can clone the opened WordprocessingDocument.
using var newDoc = (WordprocessingDocument) originalDoc.Clone("copy.docx", true);

// Perform whatever transformation you want to do.
PerformTransformation(newDoc);

You can also clone on a Stream or Package .您还可以在StreamPackage上进行克隆。 Overall, you have the following options:总的来说,您有以下选择:

OpenXmlPackage Clone()

OpenXmlPackage Clone(Stream stream)
OpenXmlPackage Clone(Stream stream, bool isEditable)
OpenXmlPackage Clone(Stream stream, bool isEditable, OpenSettings openSettings)

OpenXmlPackage Clone(string path)
OpenXmlPackage Clone(string path, bool isEditable)
OpenXmlPackage Clone(string path, bool isEditable, OpenSettings openSettings)

OpenXmlPackage Clone(Package package)
OpenXmlPackage Clone(Package package, OpenSettings openSettings)

Have a look at the Open XML SDK documentation for details on those methods.有关这些方法的详细信息,请查看 Open XML SDK 文档。

Having said that, if you have not yet opened the WordprocessingDocument , there are at least faster ways to duplicate, or clone, the document.话虽如此,如果您还没有打开WordprocessingDocument ,那么至少有更快的方法来复制或克隆文档。 I've demonstrated this in my answer on the most efficient way to clone Office Open XML documents .我已经在有关克隆 Office Open XML 文档的最有效方法的回答中证明了这一点。

When you look at an openxml document by changing the extension to zip and opening it you see that that word subfolder contains a _rels folder where all the relations are listed.当您通过将扩展名更改为 zip 并打开它来查看 openxml 文档时,您会看到该 word 子文件夹包含一个 _rels 文件夹,其中列出了所有关系。 These relations point to the parts you mentioned (style ...).这些关系指向您提到的部分(样式...)。 Actually you need these parts because they contain the definition of the formatting.实际上您需要这些部分,因为它们包含格式的定义。 So not copying them will cause the new document to use the formatting defined in the normal.dot file and not the one defined in the original document.因此,不复制它们将导致新文档使用 normal.dot 文件中定义的格式,而不是原始文档中定义的格式。 So I think you have to copy them.所以我认为你必须复制它们。

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM