Aspose.Words Dokumenten-Merger für .NET

Der Aspose.Words Document Merger für .NET ** ermöglicht es Ihnen, programmatisch ** jede Anzahl von Word-kompatiblen Dokumenten in eine einzige Ausgabe einzuschließen, während Formatierung, Styles, Seitenlayout, Header/Footers und Felder beibehalten.

Funktioniert auf Windows, Linux und macOS. Kein Microsoft Office erforderlich.

Installation und Setup

  • Installieren Sie das NuGet-Paket Aspose.Words.
  • Verwenden Sie bei App Startup messende Lizenzierung, um Bewertungswassermarken zu vermeiden. siehe Metered Licensing .
  • Überprüfen Sie die Rahmenanforderungen im Installationsguide .

Unterstützte Einträge (selekt): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Unterstützte Outputs: DOCX, DOC, PDF, HTML (fixed/flow), MHTML, ODT, RTF, Bilder, EPUB, XPS und mehr.

Schneller Start: Mehrere Dokumente hinzufügen 

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");

Einfuhrformat Modes

  • KeepSourceFormatting – bewahrt die Stile jeder Quelle und die direkte Formatierung (ideal für markante Einträge).
  • UseDestinationStyles – Karten identische Stilnamen zu den Definitionen des Ziels für ein einheitliches Aussehen.

Kontrollierte Abschnitt & Page Layout

Beginnen Sie jedes Dokument mit **Neue Seite ** , **Continuous ** oder Even/Odd Page:

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

Unify Margins/Seite Größe durch Kopieren PageSetup Aus einem Template Abschnitt:

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;
}

Headers, Footers und Wassermarken

Halten Sie die Quellheads/Footers oder ersetzen Sie sie mit einem Master-Set nach der Mischung:

// 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);
}

Felder, Kreuzreferenzen und TOC

Nach der Fusion aktualisieren Sie die Felder, so dass Seitennummern, Referenzen und Tabelle von Inhalten den neuen Layout entsprechen:

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

Wenn Sie eine einzige Master-TOC beibehalten, geben Sie sie einmal ein und lassen Sie es automatisch wiederholen:

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

Passwortgeschütztes Input & Secure Output 

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 / Hochvolumen Merges 

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
}

Leistungstücke

  • Batch Appends im Gedächtnis; Call UpdateFields() Einmal am Ende.
  • Präferieren Sie UseDestinationStyles , wenn Sie konsequente Styling über Dutzende von Einträgen wünschen.
  • Dispose Document Anfänge früh in langen Pipelinen, um die Spitze des Gedächtnisses zu reduzieren.

Verarbeitung gemischter Formate (HTML, PDF, TXT)

  • HTML/MHTML : Einfuhren mit Stilen und Bildern (verbindet oder eingebettet).
  • PDF : Seiten werden möglichst als wiederflüssiges Inhalt importiert; komplexe Layouts werden während der Ausgabe in fester Formate (z. B. PDF) beibehalten).
  • TXT : als reine Absätze hinzugefügt; ein Basistil nach dem Import für Konsistenz anzuwenden.

Beste Praktiken

  • Pre-validate für Korruption/Passwörter, um teilweise Mischungen zu vermeiden.
  • Wählen Sie **KeepSourceFormatting ** , wenn die Marke treu ist; wählen sie UseDestinationStyles für einheitliches Aussehen aus.
  • Geben Sie eine Sektion Break vor jedem Append ein, um die Seiteinstellung zu schützen.
  • Unify Header/Footers nach der Anschließung, wenn Sie ein einziges Unternehmen-Template möchten.
  • Aktualisieren Sie die Felder & TOC als letzte Schritte.
  • Für sehr große Kämpfe, teilen Sie in Gruppen und vereinen die Gruppen, um das Gedächtnis stabil zu halten.

FAQ

**Kann ich jede Quelle dazu zwingen, auf einer neuen Seite zu beginnen?**Ja. Einfügen Sie einen Abschnitt oder eine Seite vor jedem AppendDocument Anrufen oder Set SectionStart zu NewPage.

**Wie behalten wir Zielstile während der Einfuhr?**Use ImportFormatMode.UseDestinationStyles in AppendDocument.

**Will die Seitennummer und TOC automatisch aktualisieren?**Call UpdateFields() (und UpdatePageLayout() für präzise Pageination) nach allen Appends.

**Kann ich verschlüsselte Einträge miteinander kombinieren und Verschlüsselte Ausgabe produzieren?**Ja, bieten Sie LoadOptions.Password für Einträge und Verwendung PdfSaveOptions.EncryptionDetails (oder OoxmlSaveOptions.Password) für die Produktion.

**Ist das Büro erforderlich?**No. Aspose.Words ist eine einzigartige Bibliothek.

 Deutsch