Aspose.Words Dokument Mergowania dla .NET

Aspose.Words Document Merger dla .NET pozwala programowo przyłączyć dowolną liczbę dokumentów zgodnych z Word do jednego wyjścia, zachowując jednocześnie formatowanie, style, układ strony, nagłówki / stopy i pola.

Funkcjonuje bezprzewodowo w systemie Windows, Linux i macOS. Nie wymaga Microsoft Office.

Instalacja i ustawienie

  • Instalacja pakietu NuGet Aspose.Words.
  • Aplikuj licencję mierzoną na startupie aplikacji, aby uniknąć oceny znaków wodnych. Zobacz Licencje mierzone .
  • Sprawdź wymagania ramowe w Installation Guide .

Popierane wpisy (wybrana): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Popierane wyniki: DOCX, DOC, PDF, HTML (fiksowany / przepływ), MHTML, ODT, RTF, obrazy, EPUB, XPS i wiele innych.

Szybki start: dodawanie wielu dokumentów 

using Aspose.Words;

// Destination (master) document
var master = new Document();
var builder = new DocumentBuilder(master);

// Start on a clean page
builder.InsertBreak(BreakType.SectionBreakNewPage);

// Append each source with chosen import mode
ImportFormatMode mode = ImportFormatMode.KeepSourceFormatting; // or UseDestinationStyles

foreach (string path in new [] { "intro.docx", "spec.docx", "annex.rtf" })
{
    var src = new Document(path);
    master.AppendDocument(src, mode);
    // Optional: force each source to start on a new page
    builder.MoveToDocumentEnd();
    builder.InsertBreak(BreakType.SectionBreakNewPage);
}

// Refresh fields (page numbers, TOC, cross‑refs)
master.UpdateFields();
master.Save("MergedOutput.pdf");

Moduł importu

  • KeepSourceFormatting – zachowuje styl każdego źródła i bezpośrednie formatowanie (idealne dla wkładów marki).
  • UseDestinationStyles – mapuje identyczne nazwy stylowe do definicji miejsca docelowego dla unikalnego wyglądu.

Kontrolowana sekcja i layout strony

Rozpocznij każdy dokument na **Nowej stronie ** , **Continuous ** lub Even/Odd Page:

var sect = master.LastSection;
sect.PageSetup.SectionStart = SectionStart.NewPage; // Continuous, EvenPage, OddPage

Unify marginy/rozmiar strony poprzez kopiowanie PageSetup z sekcji szablonu:

var template = new Document("template.docx");
var pageSetup = template.FirstSection.PageSetup;
foreach (Section s in master.Sections)
{
    s.PageSetup.Orientation = pageSetup.Orientation;
    s.PageSetup.PageWidth  = pageSetup.PageWidth;
    s.PageSetup.PageHeight = pageSetup.PageHeight;
    s.PageSetup.TopMargin  = pageSetup.TopMargin;
    s.PageSetup.BottomMargin = pageSetup.BottomMargin;
    s.PageSetup.LeftMargin = pageSetup.LeftMargin;
    s.PageSetup.RightMargin = pageSetup.RightMargin;
}

Głowa, stopy i znaky wody

Utrzymuj główki źródłowe / stopy, lub zastąpić je zestawem głównym po połączenia:

// Copy headers/footers from a master template into every section
var hft = new Document("header-footer-template.docx");
foreach (Section s in master.Sections)
{
    s.HeadersFooters.Clear();
    s.HeadersFooters.AddClone(hft.FirstSection.HeadersFooters[HeaderFooterType.HeaderPrimary]);
    s.HeadersFooters.AddClone(hft.FirstSection.HeadersFooters[HeaderFooterType.FooterPrimary]);
}

// Add a simple text watermark
foreach (Section s in master.Sections)
{
    var header = s.HeadersFooters[HeaderFooterType.HeaderPrimary] ?? new HeaderFooter(master, HeaderFooterType.HeaderPrimary);
    if (header.ParentNode == null) s.HeadersFooters.Add(header);
    var shape = new Shape(master, ShapeType.TextPlainText)
    {
        RelativeHorizontalPosition = RelativeHorizontalPosition.Page,
        RelativeVerticalPosition   = RelativeVerticalPosition.Page,
        WrapType = WrapType.None,
        Rotation = -40,
        Width = 400, Height = 100, Left = 100, Top = 200,
        BehindText = true
    };
    shape.TextPath.Text = "CONFIDENTIAL";
    header.AppendChild(shape);
}

Pole, krzyżowe odniesienia i TOC

Po połączeniu, aktualizowane pola tak, że liczby stron, odniesienia i Tabela treści odpowiadają nowemu układowi:

master.UpdateFields();
master.UpdatePageLayout();        // ensures accurate page count
master.UpdateTableLayout();       // improves complex table pagination

Jeśli utrzymujesz jeden mistrz TOC, wprowadź go raz i pozwól mu automatycznie odtworzyć:

var b = new DocumentBuilder(master);
b.MoveToDocumentStart();
b.InsertTableOfContents("TOC \o \h \z \u");  // classic TOC switch set
master.UpdateFields();

Wstępy chronione hasłem i wyjście bezpieczne 

using Aspose.Words.Loading;

var load = new LoadOptions { Password = "secret" };
var protectedDoc = new Document("protected.docx", load);
master.AppendDocument(protectedDoc, ImportFormatMode.KeepSourceFormatting);

// Save encrypted PDF
using Aspose.Words.Saving;
var pdf = new PdfSaveOptions
{
    EncryptionDetails = new PdfEncryptionDetails("openPwd", "ownerPwd",
        PdfEncryptionAlgorithm.RC4_128)
    { Permissions = PdfPermissions.DisallowAll }
};
master.Save("MergedEncrypted.pdf", pdf);

Stream-First / Merges o dużym objętości 

using (var output = new MemoryStream())
{
    var dst = new Document();
    foreach (Stream srcStream in sourceStreams)
    {
        using var s = srcStream; // e.g., S3/Blob stream
        var src = new Document(s); // auto‑detects format
        dst.AppendDocument(src, ImportFormatMode.UseDestinationStyles);
    }
    dst.UpdateFields();
    dst.Save(output, SaveFormat.Pdf);
    output.Position = 0;
    // return/output stream
}

Tipy wydajności

  • Batch włączony w pamięć; wezwanie UpdateFields() Raz na koniec.
  • Prefer UseDestinationStyles , gdy chcesz konsekwentnego stylizacji w dziesiątkach wpisów.
  • Dispose Document Wczesne przykłady w długich rurociągach, aby zmniejszyć pamięć szczytu.

Zarządzanie mieszanymi formatami (HTML, PDF, TXT)

  • HTML/MHTML: importowane ze stylami i obrazami (włączonymi lub wbudowanymi).
  • PDF : strony są importowane jako ponowne treści, gdzie to możliwe; złożone układy są przechowywane podczas wyjścia do stałych formatów (np. PDF).
  • TXT : załączony jako płaski paragraf; zastosowanie stylu bazowego po imporcie dla spójności.

Najlepsze praktyki

  • Pre-validate dla korupcji / hasła w celu uniknięcia częściowych połączeń.
  • Wybierz KeepSourceFormatting , gdy wiarygodność marki jest ważna; wybierz UseDestinationStyles dla wyglądu uniwersalnego.
  • Wprowadź przerwę sekcji przed każdym załącznikiem, aby chronić ustawienie strony.
  • Unify nagłówki / stopy po załączeniu, jeśli chcesz pojedynczego szablonu korporacyjnego.
  • Aktualizuj pola i TOC jako ostatni krok.
  • Dla bardzo dużych meczów, podziel się na grupy i połączyć grupy, aby utrzymać pamięć stabilną.

FAQ

**Czy mogę zmusić każdy źródło do rozpoczęcia na nowej stronie?**Wprowadź sekcję lub przerwę strony przed każdym AppendDocument Zadzwoń lub ustaw SectionStart do NewPage.

**Jak utrzymywać styly docelowe podczas importu?**Używanie ImportFormatMode.UseDestinationStyles w AppendDocument.

**Czy numery stron i TOC będą aktualizowane automatycznie?**Zadzwoń UpdateFields() (i UpdatePageLayout() i dokładnej strony) po wszystkich załącznikach.

**Czy mogę łączyć szyfrowane wpisy i wytwarzać szyfrowane wyniki?**Zapewnij LoadOptions.Password do wejścia i użytkowania PdfSaveOptions.EncryptionDetails (lub OoxmlSaveOptions.Password) i do produkcji.

**Czy jest to potrzebne biuro?**No. Aspose.Words to niezależna biblioteka.

 Polski