ImportNode

ImportNode(Node, bool)

将节点从另一个文档导入到当前文档。

public Node ImportNode(Node srcNode, bool isImportChildren)
范围类型描述
srcNodeNode正在导入的节点。
isImportChildrenBoolean真的递归导入所有子节点；否则，错误的。

返回值

属于当前文档的克隆节点。

评论

此方法使用UseDestinationStyles解决格式问题的选项。

导入节点会创建属于导入文档的源节点的副本。 返回的节点没有父节点。源节点不会被更改，也不会从原始文档中删除。

在将其他文档中的节点插入到本文档之前，必须先将其导入。 在导入过程中，文档特定的属性（例如对样式和列表的引用）会从原始文档转换到导入文档。 导入节点后，可以使用以下命令将其插入到文档中的相应位置。InsertBefore或 InsertAfter。

如果源节点已经属于目标文档，则只需创建源节点的深度 clone 。

例子

展示如何将节点从一个文档导入到另一个文档。

Document srcDoc = new Document();
Document dstDoc = new Document();

srcDoc.FirstSection.Body.FirstParagraph.AppendChild(
    new Run(srcDoc, "Source document first paragraph text."));
dstDoc.FirstSection.Body.FirstParagraph.AppendChild(
    new Run(dstDoc, "Destination document first paragraph text."));

// 每个节点都有一个父文档，即包含该节点的文档。
// 将节点插入到不属于该节点的文档中将引发异常。
Assert.AreNotEqual(dstDoc, srcDoc.FirstSection.Document);
Assert.Throws<ArgumentException>(() => dstDoc.AppendChild(srcDoc.FirstSection));

// 使用 ImportNode 方法创建一个节点的副本，该副本将包含文档
// 调用 ImportNode 方法将其设置为新的所有者文档。
Section importedSection = (Section)dstDoc.ImportNode(srcDoc.FirstSection, true);

Assert.AreEqual(dstDoc, importedSection.Document);

// 我们现在可以将节点插入到文档中。
dstDoc.AppendChild(importedSection);

Assert.AreEqual("Destination document first paragraph text.\r\nSource document first paragraph text.\r\n",
    dstDoc.ToString(SaveFormat.Text));

也可以看看

ImportNode(Node, bool, ImportFormatMode)

将节点从另一个文档导入到当前文档，并提供控制格式的选项。

public Node ImportNode(Node srcNode, bool isImportChildren, ImportFormatMode importFormatMode)
范围类型描述
srcNodeNode要导入的节点。
isImportChildrenBoolean真的递归导入所有子节点；否则，错误的。
importFormatModeImportFormatMode指定如何合并冲突的样式格式。

返回值

克隆的导入节点。该节点属于目标文档，但没有父节点。

评论

此重载对于控制如何导入样式和列表格式很有用。

导入节点会创建属于导入文档的源节点的副本。 返回的节点没有父节点。源节点不会被更改，也不会从原始文档中删除。

在将其他文档中的节点插入到本文档之前，必须先将其导入。 在导入过程中，文档特定的属性（例如对样式和列表的引用）会从原始文档转换到导入文档。 导入节点后，可以使用以下命令将其插入到文档中的相应位置。InsertBefore或 InsertAfter。

如果源节点已经属于目标文档，则只需创建源节点的深度 clone 。

例子

显示如何使用特定选项将节点从源文档导入到目标文档。

// 创建两个文档并为每个文档添加一个字符样式。
// 将样式配置为具有相同的名称，但具有不同的文本格式。
Document srcDoc = new Document();
Style srcStyle = srcDoc.Styles.Add(StyleType.Character, "My style");
srcStyle.Font.Name = "Courier New";
DocumentBuilder srcBuilder = new DocumentBuilder(srcDoc);
srcBuilder.Font.Style = srcStyle;
srcBuilder.Writeln("Source document text.");

Document dstDoc = new Document();
Style dstStyle = dstDoc.Styles.Add(StyleType.Character, "My style");
dstStyle.Font.Name = "Calibri";
DocumentBuilder dstBuilder = new DocumentBuilder(dstDoc);
dstBuilder.Font.Style = dstStyle;
dstBuilder.Writeln("Destination document text.");

// 将目标文档中的 Section 导入源文档，导致样式名称冲突。
// 如果我们使用目标样式，则导入的源文本具有相同的样式名称
// 因为目标文本将采用目标样式。
Section importedSection = (Section)dstDoc.ImportNode(srcDoc.FirstSection, true, ImportFormatMode.UseDestinationStyles);
Assert.AreEqual(dstStyle.Font.Name, importedSection.Body.FirstParagraph.Runs[0].Font.Name);
Assert.AreEqual(dstStyle.Name, importedSection.Body.FirstParagraph.Runs[0].Font.StyleName);

// 如果我们使用 ImportFormatMode.KeepDifferentStyles，源样式将被保留，
// 并且通过添加后缀来解决命名冲突。
dstDoc.ImportNode(srcDoc.FirstSection, true, ImportFormatMode.KeepDifferentStyles);
Assert.AreEqual(dstStyle.Font.Name, dstDoc.Styles["My style"].Font.Name);
Assert.AreEqual(srcStyle.Font.Name, dstDoc.Styles["My style_0"].Font.Name);

也可以看看

DocumentBase.WarningCallback