Vložit a doplnit dokumenty

Někdy je nutné kombinovat několik dokumentů do jednoho. Můžete to udělat ručně nebo můžete použít Aspose.Words vložit nebo připojit funkci.

Operace vložení umožňuje vložit obsah dříve vytvořených dokumentů do nového nebo stávajícího dokumentu.

Funkce Append vám pak umožní přidat dokument pouze na konci jiného dokumentu.

Tento článek vysvětluje, jak vložit nebo přidat dokument do jiného dokumentu různými způsoby a popisuje společné vlastnosti, které můžete použít při vkládání nebo zadávání dokumentů.

Vložit dokument

Jak bylo uvedeno výše, Aspose.Words dokument je reprezentován jako strom uzlů a operace vložení jednoho dokumentu do druhého je kopírování uzlů od prvního stromu dokumentu do druhého.

Dokumenty můžete vkládat do různých míst různými způsoby. Můžete například vložit dokument prostřednictvím náhradní operace, pole sloučení během operace sloučení nebo prostřednictvím záložky.

Můžete také použít InsertDocument nebo InsertDocumentInline metoda, která je podobná vložení dokumentu do Microsoft Word, vložit celý dokument do aktuální polohy kurzoru bez předchozího dovozu.

Následující příklad kódu ukazuje, jak vložit dokument pomocí InsertDocument metoda:

Následující příklad kódu ukazuje, jak vložit dokument pomocí InsertDocumentInline metoda:

Následující pododdíly popisují možnosti, během kterých můžete vložit jeden dokument do druhého.

Vložit dokument během hledání a nahrazení operace

Můžete vložit dokumenty při provádění hledání a nahrazení operací. Například dokument může obsahovat odstavce s textem [PRODUKCE] a [CONCLUZE]. Ale v závěrečném dokumentu musíte tyto odstavce nahradit obsahem získaným z jiného vnějšího dokumentu. Abyste toho dosáhli, budete muset vytvořit spojku pro výměnu událostí.

Následující příklad kódu ukazuje, jak vytvořit manipulátor pro výměnu události použít později v procesu vložení:

Následující příklad kódu ukazuje, jak při hledání a nahrazení operace vložit obsah jednoho dokumentu do druhého:

Vložit dokument během Mail Merge Činnost

Můžete vložit dokument do pole sloučení během mail merge operace. Například: mail merge šablona může obsahovat pole sloučení jako např. [Summary]. Ale v konečném dokumentu musíte vložit obsah získaný z jiného externího dokumentu do tohoto pole sloučení. K dosažení tohoto cíle budete muset vytvořit spojku pro událost sloučení.

Následující příklad kódu ukazuje, jak vytvořit manipulátor pro fúzující událost k jeho použití později v procesu vložení:

Následující příklad kódu ukazuje, jak vložit dokument do pole sloučení pomocí vytvořeného správce:

Vložit dokument do záložky

Můžete importovat textový soubor do dokumentu a vložit jej hned po záložce, kterou jste definovali v dokumentu. Chcete-li to udělat, vytvořte záložek odstavec, kde chcete dokument vložit.

Následující kódovací příklad ukazuje, jak vložit obsah jednoho dokumentu do záložky do jiného dokumentu:

Všimněte si, že záložka by neměla obsahovat více odstavců nebo textu, které chcete, aby se objevily ve vašem konečném výsledném dokumentu.

Přidání dokumentu

Můžete mít případ použití, kde potřebujete zahrnout další stránky z dokumentu do konce stávajícího dokumentu. K tomuhle stačí zavolat AppendDocument způsob přidání dokumentu na konec jiného.

Všimněte si, že AppendChild je metoda úrovně uzel v dokumentu. Například můžete vytvořit odstavec, nastavit vlastnosti formátování a pak jej přidat jako dítě k tělu pomocí AppendChild metoda.

Následující příklad kódu ukazuje, jak připojit dokument na konec jiného dokumentu:

Importovat a vložit uzly ručně

Aspose.Words umožňuje automaticky vkládat a přidávat dokumenty bez předchozích dovozních požadavků. Pokud však potřebujete vložit nebo přidat konkrétní uzel vašeho dokumentu, jako je sekce nebo odstavec, pak nejprve musíte importovat tento uzel ručně.

Pokud potřebujete vložit nebo připojit jeden oddíl nebo odstavec k druhému, musíte v podstatě importovat uzly prvního uzel dokumentu do druhého stromu pomocí ImportNode metoda. Po importu uzlů musíte použít InsertAfter metoda vložení nového uzlu po / před referenčním uzlem. To vám umožní přizpůsobit proces vkládání importem uzlů z dokumentu a vložením na dané pozice.

Můžete také použít AppendChild způsob, jak přidat nový zadaný uzel na konec seznamu dětských uzlů, například, pokud chcete přidat obsah na úrovni odstavce místo na úrovni sekce.

Následující příklad kódu ukazuje, jak ručně importovat uzly a vložit je po konkrétním uzlu pomocí InsertAfter metoda:

Import vytvoří nový uzel, který je kopií původního uzlu a vhodný pro vložení do cílového dokumentu.

Obsah se do sekce cílového dokumentu importuje podle oddílu, což znamená, že nastavení, jako je nastavení stránek a hlavičky nebo zápatí, jsou zachována během importu. Je také užitečné poznamenat, že můžete definovat nastavení formátování, když vložíte nebo připojíte dokument pro upřesnění, jak jsou dva dokumenty spojeny dohromady.

Společné vlastnosti pro vložení a doplnění dokumentů

Oba InsertDocument a AppendDocument metody akceptují ImportFormatMode a ImportFormatOptions jako vstupní parametry. The ImportFormatMode umožňuje ovládat, jak je formátování dokumentů sloučeno, když importujete obsah z jednoho dokumentu do druhého výběrem různých formátů, jako jsou UseDestinationStyles, KeepSourceFormatting, a KeepDifferentStyles. The ImportFormatOptions umožňuje vybrat různé možnosti importu, jako je IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, a SmartStyleBehavior.

Aspose.Words umožňuje upravit vizualizaci výsledného dokumentu, pokud jsou dva dokumenty přidány společně v insertu nebo do přílohy operací pomocí Section a PageSetup vlastnosti. The PageSetup vlastnost obsahuje všechny atributy oddílu jako např. SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, a další. Nejčastějším případem použití je nastavení SectionStart vlastnost definovat, zda se přidaný obsah objeví na stejné stránce nebo se rozdělí na nový.

Všimněte si, že Section a PageSetup vlastnosti nekontrolují, jak jsou dva dokumenty vloženy/přidány společně. Umožňují vám pouze změnit vzhled vašeho výsledného dokumentu.

Následující příklad kódu ukazuje, jak připojit jeden dokument k druhému a zároveň udržet obsah od rozdělení na dvě stránky: