Wstaw i załącz dokumenty

Czasami wymagane jest połączenie kilku dokumentów w jedno. Możesz to zrobić ręcznie lub możesz użyć Aspose.Words wstawić lub dołączyć funkcję.

Operacja insert pozwala na dodanie zawartości wcześniej utworzonych dokumentów do nowej lub istniejącej.

Z kolei funkcja append pozwala na dodanie dokumentu tylko na końcu innego dokumentu.

Ten artykuł wyjaśnia, w jaki sposób wstawić lub dołączyć dokument do innego dokumentu na różne sposoby i opisuje wspólne właściwości, które można stosować podczas wprowadzania lub dodawania dokumentów.

Wstaw dokument

Jak wspomniano powyżej, w Aspose.Words dokument jest przedstawiany jako drzewo węzłów, a działanie wstawiania jednego dokumentu do drugiego polega na kopiowaniu węzłów od pierwszego drzewa dokumentów do drugiego.

Dokumenty można umieszczać w różnych miejscach na różne sposoby. Na przykład, można wstawić dokument poprzez operację wymiany, pole scalania podczas operacji łączenia lub poprzez zakładkę.

Można również użyć InsertDocument lub InsertDocumentInline metoda, która jest podobna do wstawiania dokumentu w Microsoft Word, wstawić cały dokument na bieżącej pozycji kursora bez wcześniejszego przywozu.

Poniższy przykład kodu pokazuje jak wstawić dokument używając InsertDocument Metoda:

Poniższy przykład kodu pokazuje jak wstawić dokument używając InsertDocumentInline Metoda:

Poniższe podsekcje opisują opcje, podczas których można umieścić jeden dokument w innym.

Wstaw dokument podczas wyszukiwania i zamiany operacji

Podczas wykonywania operacji znajdź i zastąp. Na przykład dokument może zawierać ustępy z tekstem [WPROWADZENIE] i [WNIOSEK]. Jednak w dokumencie końcowym należy zastąpić te ustępy treścią otrzymaną z innego dokumentu zewnętrznego. Aby to osiągnąć, trzeba będzie utworzyć opiekuna dla zdarzenia zastępczego.

Poniższy przykład kodu pokazuje, jak utworzyć opiekuna dla zdarzenia zastępującego, aby używać go później w procesie wprowadzania:

Poniższy przykład kodu pokazuje, jak wstawić zawartość jednego dokumentu do drugiego podczas operacji wyszukiwania i zastępowania:

Wstaw dokument podczas Mail Merge Działanie

Można umieścić dokument w polu połączenia podczas Mail Merge działanie. Na przykład Mail Merge szablon może zawierać pole scalania, takie jak [podsumowanie]. Jednak w dokumencie końcowym należy umieścić zawartość otrzymaną z innego dokumentu zewnętrznego w tym polu. Aby to osiągnąć, trzeba będzie utworzyć opiekuna dla zdarzenia połączenia.

Poniższy przykład kodu pokazuje, jak utworzyć opiekuna dla łączącego się zdarzenia do wykorzystania go później w procesie wprowadzania:

Poniższy przykład kodu pokazuje, jak wstawić dokument do pola połączenia za pomocą utworzonego opiekuna:

Wstaw dokument na zakładce

Możesz zaimportować plik tekstowy do dokumentu i wstawić go zaraz po zakładce zdefiniowanej w dokumencie. Aby to zrobić, należy utworzyć ustęp z zakładkami, w którym chcesz umieścić dokument.

Poniższy przykład kodowania pokazuje jak umieścić zawartość jednego dokumentu na zakładce w innym dokumencie:

Zauważ, że zakładka nie powinna zawierać wielu akapitów lub tekstu, które chcesz, aby zostały wyświetlone w ostatecznym dokumencie.

Dołącz dokument

Możesz mieć przypadek użycia, w którym musisz dołączyć dodatkowe strony od dokumentu do końca istniejącego dokumentu. Aby to zrobić, wystarczy zadzwonić do AppendDocument metoda dodawania dokumentu do końca innego dokumentu.

Zauważ, że AppendChild jest metodą poziomu węzła w dokumencie. Na przykład, można utworzyć paragraf, ustawić właściwości formatowania, a następnie dołączyć go jako dziecko do ciała za pomocą AppendChild Metoda.

Poniższy przykład kodu pokazuje, jak dołączyć dokument do końca innego dokumentu:

Importuj i wstaw węzły ręcznie

Aspose.Words pozwala na automatyczne wstawianie i uzupełnianie dokumentów bez żadnych wcześniejszych wymagań importowych. Jednakże, jeśli musisz wstawić lub dołączyć określony węzeł dokumentu, np. sekcję lub paragraf, najpierw musisz zaimportować ten węzeł ręcznie.

Gdy musisz wstawić lub dołączyć jedną sekcję lub paragraf do innej, musisz w zasadzie zaimportować węzły pierwszego drzewa węzłów dokumentu do drugiej z wykorzystaniem ImportNode Metoda. Po importowaniu węzłów, należy użyć InsertAfter metoda wprowadzania nowego węzła po / przed węzłem odniesienia. Pozwala to dostosować proces wprowadzania poprzez importowanie węzłów z dokumentu i wstawianie go na określonych pozycjach.

Można również użyć AppendChild metoda dodawania nowego określonego węzła do końca listy węzłów dziecięcych, na przykład, jeśli chcesz dołączyć zawartość na poziomie paragrafu zamiast na poziomie sekcji.

Poniższy przykład kodu pokazuje, jak ręcznie importować węzły i umieszczać je po określonym węźle za pomocą InsertAfter Metoda:

Import tworzy nowy węzeł, który jest kopią oryginalnego węzła i nadaje się do umieszczenia w dokumencie docelowym.

Zawartość jest importowana do sekcji dokumentu docelowego według sekcji, co oznacza, że ustawienia, takie jak konfiguracja strony i nagłówki lub stopki, są zachowane podczas importu. Warto również zauważyć, że można zdefiniować ustawienia formatowania przy wstawianiu lub dołączaniu dokumentu w celu określenia sposobu łączenia dwóch dokumentów.

Common Properties for insert and Append Documents

Oba InsertDocument oraz AppendDocument metody przyjęte ImportFormatMode oraz ImportFormatOptions jako parametry wejściowe. W ImportFormatMode pozwala kontrolować sposób łączenia formatowania dokumentów przy importowaniu treści z jednego dokumentu do drugiego poprzez wybór różnych trybów formatowania, takich jak: UseDestinationStyles, KeepSourceFormatting, oraz KeepDifferentStyles. W ImportFormatOptions pozwala wybrać różne opcje importu, takie jak IgnoreHeaderFooter, IgnoreTextBoxes, KeepSourceNumbering, MergePastedLists, oraz SmartStyleBehavior.

Aspose.Words pozwala dostosować wizualizację otrzymanego dokumentu, gdy dwa dokumenty są dodawane do wstawić lub dołączyć operacji za pomocą Section oraz PageSetup nieruchomości. W PageSetup właściwość zawiera wszystkie atrybuty sekcji, takie jak SectionStart, RestartPageNumbering, PageStartingNumber, Orientation, I innych. Najczęstszym przypadkiem zastosowania jest ustawienie SectionStart właściwość do określenia, czy dodana zawartość pojawi się na tej samej stronie lub podzielony na nową.

Należy pamiętać, że Section oraz PageSetup właściwości nie kontrolują sposobu, w jaki dwa dokumenty są wstawiane / załączane razem. Pozwalają tylko na zmianę wyglądu dokumentu wyniku.

Poniższy przykład kodu pokazuje, jak załączyć jeden dokument do drugiego, zachowując zawartość z podziałem na dwie strony: