ImportNode

ImportNode(Node, bool)

Импортирует узел из другого документа в текущий документ.

public Node ImportNode(Node srcNode, bool isImportChildren)

Параметр	Тип	Описание
srcNode	Node	Импортируемый узел.
isImportChildren	Boolean	`истинный` рекурсивно импортировать все дочерние узлы; в противном случае,`ЛОЖЬ`.

Возвращаемое значение

Клонированный узел, принадлежащий текущему документу.

Примечания

Этот метод использует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));

Смотрите также

class Node
class DocumentBase
пространство имен Aspose.Words
сборка Aspose.Words

ImportNode(Node, bool, ImportFormatMode)

Импортирует узел из другого документа в текущий документ с возможностью управления форматированием.

public Node ImportNode(Node srcNode, bool isImportChildren, ImportFormatMode importFormatMode)

Параметр	Тип	Описание
srcNode	Node	Узел для импорта.
isImportChildren	Boolean	`истинный` рекурсивно импортировать все дочерние узлы; в противном случае,`ЛОЖЬ`.
importFormatMode	ImportFormatMode	Указывает, как объединить конфликтующее форматирование стилей.

Возвращаемое значение

Клонированный импортированный узел. Узел принадлежит целевому документу, но не имеет родителя.

Примечания

Эта перегрузка полезна для управления импортом стилей и форматирования списка.

Если исходный узел уже принадлежит целевому документу, то просто создается глубокий 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 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);

Смотрите также

class Node
enum ImportFormatMode
class DocumentBase
пространство имен Aspose.Words
сборка Aspose.Words

DocumentBase.WarningCallback