Aspose.Words Document Mixer voor .NET

De **Aspose.Words Document Merger voor .NET ** stelt u in staat om programmatisch een aantal Word-compatibele documenten toe te voegen aan een enkele output, terwijl u vormgeving, stijlen, pagina-lijst, header/footers en velden behoudt.

Werkt zonder hoofd op Windows, Linux en macOS. Geen Microsoft Office vereist.

Installatie en Setup

  • Installeer het NuGet-pakket Aspose.Words.
  • Vraag een gemeten licentie aan bij app startup om beoordelingswatermarken te vermijden. zie Metered Licensing .
  • Controleer de kadervereisten in de Installatiegids .

Ondersteunde inputs (geselecteerd): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Ondersteunde output: DOCX, DOC, PDF, HTML (fixed/flow), MHTML, ODT, RTF, afbeeldingen, EPUB, XPS en meer.

Snelle start: meerdere documenten toevoegen 

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

Importformaten modes

  • KeepSourceFormatting – behoudt de stijlen van elke bron en directe vorming (ideaal voor geïntroduceerde inserts).
  • UseDestinationStyles - kaarten identieke stijlnamen aan de definities van de bestemming voor een uniforme look.

Gecontroleerde Sectie & Page Layout

Start elk document op **Nieuwe pagina ** , **Continuous ** of Even/Odd Page:

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

Unify margins/pagina grootte door te kopiëren PageSetup Van een template sectie:

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 en Watermarks

Houd de bronhoofden/footers, of vervang ze met een master set na de fusie:

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

Gebieden, kruisreferenties en TOC

Na de fusie worden de velden bijgewerkt zodat pagina-nummers, verwijzingen en Table of Contents overeenkomen met de nieuwe layout:

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

Als u een enkel master TOC behoudt, voer het een keer in en laat het automatisch teruggeven:

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

Passwordbeschermde Inputs & 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 / Hoge Volume 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
}

prestatie tips

  • Batch appends in geheugen; oproep UpdateFields() Eenmaal aan het einde.
  • Prefereren UseDestinationStyles wanneer u consistent styling over tientallen inputs wilt.
  • Dispose Document vroege instanties in lange pijpleidingen om de top geheugen te verminderen.

Verwerking van gemengde formaten (HTML, PDF, TXT)

  • HTML/MHTML : import met stijlen en afbeeldingen (verbindt of ingebed).
  • PDF : pagina’s worden waar mogelijk geïmporteerd als herflowgehalte; complexe layouts worden tijdens de uitgang bewaard in vaste formaten (bijvoorbeeld PDF).
  • TXT : aangevuld als plain paragraaf; gebruik een basisstijl na invoer voor consistentie.

Beste praktijken

  • Pre-validate voor corruptie / wachtwoorden om gedeeltelijke fusieën te voorkomen.
  • Kies **KeepSourceFormatting ** wanneer het merk betrouwbaar is; kies UseDestinationStyles voor een uniform uiterlijk.
  • Voer een section break voorafgaand aan elke toevoeging in om de pagina-instelling te beschermen.
  • Unify headers/footers na het openen als u een enkele corporate template wilt.
  • Update velden & TOC als de laatste stap.
  • Voor zeer grote batches, verdeel in groepen en samengevat de groeps om het geheugen stabiel te houden.

FAQ

**Kan ik elke bron dwingen op een nieuwe pagina te beginnen?**Een sectie of pagina breken voorafgaand aan elk AppendDocument bellen of instellen SectionStart om te NewPage.

**Hoe behoud ik bestemmingsstijlen tijdens de invoer?**Gebruik ImportFormatMode.UseDestinationStyles In de AppendDocument.

**Wilt u pagina’s en TOC automatisch bijwerken?**bellen UpdateFields() (en UpdatePageLayout() voor nauwkeurige pagina’s) na alle appends.

**Kan ik versleutelde inputs combineren en gecodeerde output produceren?**Ja, geef het LoadOptions.Password Voor inputs en gebruik PdfSaveOptions.EncryptionDetails (of OoxmlSaveOptions.Password) voor de productie.

**Is het kantoor vereist?**No. Aspose.Words is een afzonderlijke bibliotheek.

 Nederlands