Aspose.Words Dokumentfusion för .NET

Aspose.Words Document Merger för .NET gör det möjligt för dig att programmässigt lägga alla Word-kompatibla dokument till en enda output samtidigt som du behåller formatering, stilar, sidlayout, rubriker/fönster och fält. Vanliga användningar inkluderar samlarrapporter, bundlar kontraktutställningar eller aggregerar genererat innehåll för arkivering.

Fungerar direkt på Windows, Linux och macOS. Ingen Microsoft Office krävs.

Installation och installation

  • Installera NuGet-paketet Aspose.Words.
  • Applicera måttlig licens vid appstart för att undvika utvärderingsvattenmärken. Se Metered Licensing .
  • Kontrollera ramkrav i Installationsguide .

Stödda inmatningar (valda): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Stödda utgångar: DOCX, DOC, PDF, HTML (fixed/flow), MHTML, ODT, RTF, bilder, EPUB, XPS och mer.

Snabb start: Lägg till flera dokument 

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

Importera format

  • KeepSourceFormatting – bevarar stilarna för varje källa och direktformatering (ideal för märkta insatser).
  • UseDestinationStyles – kartar identiska stilnamn till destinationens definitioner för en enhetlig utseende.

Kontrollerad sektion & Page Layout

Starta varje dokument på **Ny sida ** , **Continuous ** eller Even/Odd Page:

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

Unify marginaler/sidstorlek genom att kopiera PageSetup Från en template sektion:

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

Håll källhövlar/fötter, eller ersätta dem med en mästare efter sammanslagningen:

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

Fält, korsreferenser och TOC

Efter sammanslagning uppdaterar du fälten så att sidnummer, referenser och Tabell av innehåll matchar den nya layouten:

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

Om du håller en enda master TOC, sätt in den en gång och låt den automatiskt återställas:

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

Password-skyddade inmatningar och säker utmatning 

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 / Högvolym 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
}

prestanda tips

  • Batch appends i minnet; ringa UpdateFields() En gång i slutet.
  • Föredrar UseDestinationStyles när du vill ha konsekvent styling över dussintals inmatningar.
  • Dispose Document inställningar tidigt i långa rör för att minska toppminnet.

Hantera blandade format (HTML, PDF, TXT)

  • HTML/MHTML : import med stilar och bilder (länkade eller inbäddade).
  • PDF : sidor importeras som återflödesinnehåll när det är möjligt; komplexa layouter bevaras under utgången till fasta format (t.ex. PDF).
  • TXT : bifogad som platt paragrafer; applicera en basstil efter import för konsistens.

Bästa praxis

  • Pre-validate för korruption / lösenord för att undvika partiella blandningar.
  • Välj **KeepSourceFormatting ** när varumärket är trovärdigt; välj UseDestinationStyles för enhetlig utseende.
  • Ange en section break före varje tillägg för att skydda sidinställning.
  • Unify headers/footers efter uppladdning om du vill ha en enda företagsmall.
  • Uppdatera fälten & TOC som sista steget.
  • För mycket stora matcher, dela upp i grupper och fusionera grupper för att hålla minnet stabilt.

FAQ

**Kan jag tvinga alla källor att börja på en ny sida?**Ja. Ange en sektion eller sida brytning före varje AppendDocument ringa eller ställa SectionStart till NewPage.

**Hur håller jag målstilar när jag importerar?**Användning ImportFormatMode.UseDestinationStyles i AppendDocument.

**Vill sidnummer och TOC uppdateras automatiskt?**ringer UpdateFields() (och UpdatePageLayout() för exakt sida) efter alla appenders.

**Kan jag kombinera krypterade inmatningar och producera en kryptad output?**Ja, förse LoadOptions.Password för inmatning och användning PdfSaveOptions.EncryptionDetails (eller OoxmlSaveOptions.Password) för produktionen.

**Är kontoret nödvändigt?**No. Aspose.Words är en separat bibliotek.

 Svenska