Funkcja Page Builder przekształca łączenie dokumentów, umożliwiając użytkownikom bezproblemowe łączenie stron z różnych dokumentów z precyzją i łatwością. Umożliwia łączenie stron w dowolnej kolejności, dając pełną kontrolę nad strukturą finalnego dokumentu. Niezależnie od tego, czy łączysz kilka kluczowych stron, czy tworzysz kompleksowy dokument, to narzędzie zapewnia elastyczność i efektywność. Poprzez zmniejszenie ręcznego wysiłku, upraszcza proces tworzenia dostosowanych dokumentów, oszczędzając cenny czas i zwiększając ogólną wydajność zarówno w osobistych, jak i profesjonalnych przepływach pracy.

Page Builder - jak połączyć strony z dokumentów

Następujące tematy są omówione tutaj:

Jeśli jesteś zainteresowany Merging documents online, odwiedź Online Merging Tool, który jest zasilany przez GroupDocs.

Zrozumienie narzędzia do budowy stron

Funkcja Page Builder wprowadza uproszczony sposób tworzenia niestandardowych dokumentów poprzez łączenie stron z różnych źródłowych dokumentów. Ta funkcja pozwala deweloperom na stopniowe tworzenie nowego dokumentu, dodając strony w dowolnej kolejności z dwóch lub więcej dokumentów. Oto jak działa ten proces:

  • Rozpocznij od załadowania źródłowego dokumentu Word za pomocą klasy Merger i przekaż do konstruktora jeden z dokumentów źródłowych.
  • Dołączaj dokumenty jeden po drugim, aby je połączyć przy użyciu metody Join.
  • Zainicjalizuj Page Builder. Za pomocą metody CreatePageBuilder z instancji Merger Służy to jako punkt wyjścia do tworzenia nowego dokumentu.
  • Metoda AddPage instancji Page Builder pozwala dodać do docelowego dokumentu dowolną stronę połączonych dokumentów wcześniej.
  • dla każdego dokumentu źródłowego wybierz konkretne strony, które chcesz uwzględnić w indeksie;
  • dodaj te strony do nowego dokumentu w pożądanej kolejności. Możesz łączyć i dopasowywać strony z różnych dokumentów, aby spełnić swoje potrzeby;
  • powtarzaj ten proces dla dodatkowych dokumentów źródłowych, upewniając się, że masz elastyczność w łączeniu stron w sposób, który najlepiej odpowiada Twoim wymaganiom;
  • Używając ApplyPageBuilder metody, aby zastosować zmiany z instancji Page Buildera
  • Zapisz połączony dokument w dowolnym miejscu. Gdy wszystkie potrzebne strony zostaną dodane, zapisz nowy dokument. Ostateczny wynik będzie w pełni dostosowanym plikiem zawierającym strony z różnych źródeł, uporządkowanym dokładnie tak, jak chcesz.

To podejście krok po kroku ułatwia tworzenie dokumentów dostosowanych do konkretnych przypadków użycia, takich jak kompilowanie raportów, tworzenie spersonalizowanych prezentacji lub składanie dokumentów prawnych. Dzięki Page Builder, deweloperzy mają pełną kontrolę nad kolejnością stron i treścią, eliminując potrzebę czasochłonnych ręcznych edycji i zapewniając precyzję w końcowym wyniku.

Przykładowa sprawa i implementacja kodu

Pokażmy, jak używać funkcji Page Builder w GroupDocs.Merger na praktycznym przykładzie. Aby uprościć sprawę, załóżmy, że mamy dwa dokumenty:

  • Document A z 4 stronami.
  • Document B z 4 stron.

Stawiamy sobie za cel stworzenie nowego dokumentu przez połączenie stron z tych dwóch dokumentów w różnych sekwencjach, w zależności od konkretnych scenariuszy.

Page Builder - Przykład struktury dokumentu A i B z 4 stronami każda

Here we marked each document page with document letter A, B and page number. From documents A and B we need to receive the tailored document C with the following structure

Page Builder - Przykład struktury dokumentu A i B z 4 stronami każda

Poniższy fragment kodu źródłowego pokazuje, jak scalować wybrane strony z kilku dokumentów w rezultacie dokumentu.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    
    pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
    pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
    pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
    pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
    pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
    pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Określenie zakresu wymaganych stron

Gdy pracujesz z manipulacją dokumentami, dodawanie wielu stron w sposób efektywny jest kluczowe dla obsługi złożonych przepływów pracy. Zamiast dodawać strony pojedynczo, możesz użyć metody AddPageRange, która akceptuje tablicę obiektów IPageInfo, z których każdy reprezentuje konkretną stronę. Takie podejście upraszcza proces, redukuje powtarzalny kod i poprawia wydajność, umożliwiając operacje wsadowe. Poniżej znajduje się przykład kodu demonstrujący, jak wykorzystać tę metodę do dodania wielu stron z różnych dokumentów w jednej, uproszczonej operacji.

Oto kroki, aby połączyć kilka stron z różnych dokumentów, określając je jako zakres:

  • Utwórz obiekt Merger i podaj ścieżkę lub strumień pliku źródłowego.
  • Użyj Join , aby dodać inny dokument źródłowy. Powtórz ten krok dla każdego dokumentu, który chcesz połączyć.
  • Utwórz obiekt PageBuilder poprzez wywołanie metody CreatePageBuilder.
  • Wywołaj metodę AddPageRange i przekaż tablicę obiektów IPageInfo, które opisują odpowiednie strony. Należy zauważyć, że obiekty IPageInfo używają notacji zerowej dla dokumentów źródłowych i numerów stron.
  • Użyj metody ApplyPageBuilder, aby zastosować określoną kolejność stron do scalonego dokumentu.
  • Zapisz wynikowy dokument, wywołując metodę Save i podając ścieżkę do pliku.
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
     // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
        docA.Pages[0], // Page A-1 from the document A
        docB.Pages[0], // Page B-1 from the document B
        docB.Pages[1], // Page B-2 from the document B
        docB.Pages[2], // Page B-3 from the document B
        docA.Pages[1], // Page A-2 from the document A
        docA.Pages[3], // Page A-4 from the document A                    
    };
    // Append a page of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Wnioski

Te przykłady ilustrują wszechstronność funkcji Page Builder. Deweloperzy mogą łatwo łączyć strony z wielu dokumentów w różnych sekwencjach, aby stworzyć dopasowane wyniki. Ta funkcja znacznie redukuje pracę ręczną i zapewnia precyzję w generowaniu dokumentów, co czyni ją istotnym narzędziem dla różnych zastosowań.

Get a Free API License

Możesz get a free temporary license aby korzystać z API bez ograniczeń oceny.

Zbuduj swoją własną aplikację do tworzenia stron scalania.

Oto kilka ważnych linków, które pomogą Ci w budowaniu własnej aplikacji do porównywania dokumentów.

Dokumentacja | Referencja API | Obsługiwane formaty plików

Running Examples – GitHub | Free Support Forum | Release Notes

Zobacz także

Dla uzyskania dodatkowych informacji i zasobów, możesz znaleźć następujące linki przydatne: