Aspose.Words Document Merger pentru .NET

Aspose.Words Document Merger pentru .NET vă permite să adăugați în mod programat orice număr de documente compatibile cu Word într-o singură ieșire, păstrând formatarea, stilurile, layout-ul paginii, titlurile/footers și câmpurile.

Funcționează fără cap pe Windows, Linux și macOS. Nu este necesar Microsoft Office.

Instalare și setare

  • Instalarea pachetului NuGet Aspose.Words.
  • Aplicați o licență măsurată la start-up-ul aplicației pentru a evita valorile de evaluare. Vezi Licența mărită .
  • Verificați cerințele de cadru în Guida de instalare .

Inputuri susținute (selectate): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Suportate: DOCX, DOC, PDF, HTML (fixed/flow), MHTML, ODT, RTF, imagini, EPUB, XPS și multe altele.

Start rapid: Adăugați mai multe documente 

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

Moduri de import

  • KeepSourceFormatting – păstrează stilurile fiecărei surse și formatarea directă (ideală pentru inserțiile cu branduri).
  • UseDestinationStyles – descrie nume de stil identice cu definițiile destinației pentru un aspect uniform.

Secțiunea controlată și layout-ul paginii

Începeți fiecare document pe **Noua pagină ** , **Continuă ** sau Even/Odd Page:

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

Unificați marjele / dimensiunea paginii prin copiere PageSetup Într-o secțiune de template:

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

Capetele, picioarele și marcajele de apă

Păstrați capetele de sursă / picioarele sau înlocuiți-le cu un set de master după fuzionare:

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

Câmpuri, referințe transversale și TOC

După fuzionare, actualizați câmpurile astfel încât numărul de pagini, referințele și Tabela conținutului să se potrivească cu noul layout:

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

Dacă mențineți un singur master TOC, introduceți-l o dată și lăsați să fie auto-recuperat:

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

Password-Protected Inputs & Secure Output – intrări și ieșiri sigure 

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 / Merguri cu volum ridicat 

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
}

Tipuri de performanță

  • Batch apendice în memorie; apel UpdateFields() O dată la sfârşit.
  • Preferă UseDestinationStyles atunci când doriți un stil constant peste zeci de intrări.
  • Dispose Document cazuri devreme în tuburi lungi pentru a reduce memoria de vârf.

Gestionarea formatelor mixte (HTML, PDF, TXT)

  • HTML/MHTML : importuri cu stiluri și imagini (linkate sau încorporate).
  • PDF : paginile sunt importate ca conținut reflowat acolo unde este posibil; layoutele complexe sunt păstrate în timpul ieșirii în formate fixe (de exemplu, PDF).
  • TXT : adăugat ca paragrafuri plat; aplicați un stil de bază după import pentru coerență.

Cele mai bune practici

  • Pre-validate pentru corupție / parole pentru a evita amestecurile parțiale.
  • Alegeți **KeepSourceFormatting ** atunci când este importantă fidelitatea mărcii; alegeţi UseDestinationStyles pentru un aspect uniform.
  • Introduceți o rupere a secțiunii înainte de fiecare anexă pentru a proteja setarea paginii.
  • Unificați capetele / picioarele după deschidere dacă doriți un singur șablon corporativ.
  • Actualizați câmpurile & TOC ca pasul final.
  • Pentru batch-uri foarte mari, împărțiți-vă în grupuri și fugați grupurile pentru a menține memoria stabilă.

FAQ

**Pot să forțez fiecare sursă să înceapă pe o nouă pagină?**Da. Introduceți o secțiune sau o rupere a paginii înainte de fiecare AppendDocument apel sau set SectionStart pentru NewPage.

**Cum pot păstra stilurile de destinație în timp ce import?**Utilizarea ImportFormatMode.UseDestinationStyles în AppendDocument.

**Vrei să actualizezi numărul de pagini și TOC automat?**apeluri UpdateFields() (şi UpdatePageLayout() pentru pagini precise) după toate apendicele.

**Put să amestec intrările criptate și să produc o cifră de ieșire?**Da, furnizează LoadOptions.Password pentru intrări și utilizare PdfSaveOptions.EncryptionDetails (sau OoxmlSaveOptions.Password) pentru producţie.

**Este necesar un birou?**Aspose.Words este o bibliotecă independentă.

 Română