Aspose.Words Document Merger per a .NET

El **Aspose.Words Document Merger per a .NET ** li permet programàticament adhereix qualsevol nombre de documents compatibles amb Word a una única sortida mentre conserva el format, els estils, el layout de la pàgina, les titelles/fots i els camps.

Funciona sense cap tipus en Windows, Linux i macOS. No requereix Microsoft Office.

Instal·lació i configuració

  • Instal·la el paquet NuGet Aspose.Words.
  • Aplica la llicència mesurada a la startup de l’aplicació per evitar les puntuacions d’avaluació. Veure [Llicències mesurades]715c8eafc621/).
  • Verifiqueu els requisits del marc a Guia d’instal·lació .

Suportats: DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Suportats: DOCX, DOC, PDF, HTML (fix/flow), MHTML, ODT, RTF, imatges, EPUB, XPS, i més.

Iniciació ràpida: afegir diversos documents 

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

Modes d’importació

  • KeepSourceFormatting – conserva els estils de cada font i el formatament directe (ideal per a les insercions amb marca).
  • UseDestinationStyles — mapes de noms d’estil idèntics a les definicions de la destinació per a una mirada uniforme.

Secció controlada i layout de pàgines

Iniciar cada document amb **Nova pàgina ** , **Continuous ** o Even/Odd Page:

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

Unificació de marges / mida de pàgina per copiar PageSetup Des d’una secció de temàtiques:

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

Caps, peus i marques d’aigua

Mantenir els capçalers de font/foters, o reemplaçar-los amb un conjunt principal després de la fusió:

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

Camps, referències transversals i TOC

Després de la fusió, actualitzar els camps de manera que els números de pàgines, referències i Table de continguts coincideixen amb el nou disseny:

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

Si manté un únic TOC mestre, insereu-lo una vegada i deixeu que es recuperi automàticament:

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

Password-Protected Inputs i 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);

Merges de flux-primer / volum elevat 

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
}

Tipus d’actuació

  • Batch apèndix en la memòria; trucar UpdateFields() Una vegada al final.
  • Prefer UseDestinationStyles quan vols estilitzar de manera coherent a través de desenes d’ingressos.
  • Dispose Document instàncies primerenques en els tubs llargs per reduir la memòria de punta.

Gestió de formats mixtes (HTML, PDF, TXT)

  • HTML/MHTML : imports amb estils i imatges (enllaç o embedded).
  • PDF : les pàgines s’importen com a contingut reflut on sigui possible; es conserven dissenys complexos durant la sortida en formats fixos (per exemple, PDF).
  • TXT : afegit com a paràgrafs plaus; aplicar un estil de base després d’importació per a la consistència.

Les millors pràctiques

  • Pre-valida per a la corrupció / contrasenyes per evitar fusions parcials.
  • Selecciona **KeepSourceFormatting ** quan la fidelitat de la marca importa; triï UseDestinationStyles per a l’aspecte uniforme.
  • Insereix una secció interrupció abans de cada app per protegir la configuració de la pàgina.
  • Unify headers/footers després de l’apenament si voleu un únic template corporatiu.
  • Actualitza els camps i TOC com a pas final.
  • Per a batxes molt grans, es divideix en grups i s’uneix els grupos per mantenir la memòria estable.

FAQ

**Puc obligar cada font a començar en una nova pàgina?**Sí. Insereix una secció o pausa de pàgina abans de cada AppendDocument trucar o establir SectionStart per a NewPage.

**Com puc mantenir els estils de destinació mentre importa?**Use ImportFormatMode.UseDestinationStyles En el AppendDocument.

**Vols que els números de pàgines i TOC actualitzen automàticament?**Call UpdateFields() (i UpdatePageLayout() per a la pàgina exacta) després de tots els apendiments.

**Puc fusionar les entrades encriptades i produir una sortida encripta?**Sí, proveïm LoadOptions.Password Per a les entrades i l’ús PdfSaveOptions.EncryptionDetails (o OoxmlSaveOptions.Password) per a la producció.

**És necessària l’oficina?**No. Aspose.Words és una biblioteca independent.

 Català