Fonditore di documenti Aspose.Words per .NET

Il **Aspose.Words Document Merger per .NET ** ti consente di programmaticamente aggiungere qualsiasi numero di documenti Word-compatibili in una singola uscita mantenendo la formattazione, gli stili, la layout della pagina, i titoli/footers e i campi.

Funziona senza testa su Windows, Linux e macOS. Nessun Microsoft Office richiesto.

Installazione e Setup

  • Installare il pacchetto NuGet Aspose.Words.
  • Applicare la licenza misurata all’applicazione startup per evitare indicazioni di valutazione. Vedi Licenza misura .
  • Verificare i requisiti di quadro nella Guida all’installazione .

Supportati input (selezionati): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Risultati supportati: DOCX, DOC, PDF, HTML (fisso / flusso), MHTML, ODT, RTF, immagini, EPUB, XPS e altro ancora.

Inizio rapido: aggiungere molti documenti 

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

Modalità di importazione

  • KeepSourceFormatting – conserva gli stili di ciascuna fonte e la formattazione diretta (ideale per inserzioni marchiate).
  • UseDestinationStyles – mappa nomi di stile identici alle definizioni della destinazione per un aspetto uniforme.

Sezione controllata e layout di pagina

Inizia ogni documento con **Nuova pagina ** , **Continuo ** o Even/Odd Page:

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

Unificare margini / dimensioni di pagina copiando PageSetup Dalla sezione 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;
}

Capelli, piede e marchi d’acqua

Mantenere i capolavori di sorgente, o sostituirli con un master set dopo la fusione:

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

Campi, Cross-Referenze e TOC

Dopo la fusione, aggiornare i campi in modo che i numeri di pagine, i riferimenti e Table of Contents corrispondano al nuovo layout:

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

Se si mantiene un unico master TOC, inserisci una volta e lasciatelo ripristinare automaticamente:

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

Password-Protected Inputs e 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 / Merges di volume elevato 

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
}

Tipi di prestazioni

  • Batch append in memoria; chiama UpdateFields() Una volta alla fine.
  • Preferisci UseDestinationStyles quando vuoi uno stile costante su decine di input.
  • Dispose Document Gli esempi in anticipo nei lunghi tubi per ridurre la memoria di punta.

Gestione dei formati misti (HTML, PDF, TXT)

  • HTML/MHTML : importati con stili e immagini (linkate o incorporate).
  • PDF : le pagine vengono importate come contenuto riflusso se possibile; i layout complessi vengono conservati durante la produzione in formati fissati (ad esempio, PDF).
  • TXT : allegato come paragrafi piani; applicare uno stile di base dopo l’importazione per la coerenza.

Migliori pratiche

  • Pre-validate per corruzione/password per evitare fusioni partiali.
  • Scegli **KeepSourceFormatting ** quando la fidelità del marchio è importante; scegli UseDestinationStyles per un aspetto uniforme.
  • Inserisci una sezione interruzione prima di ogni append per proteggere la configurazione della pagina.
  • Unifichi i capolavori/piedi dopo l’applicazione se si desidera un singolo modello aziendale.
  • Aggiornare i campi & TOC come passo finale.
  • Per battaglie molto grandi, dividere in gruppi e fusione i gruppo per mantenere la memoria stabile.

FAQ

**Posso costringere ogni fonte a iniziare su una nuova pagina?**Inserisci una sezione o una pagina interrotta prima di ciascuna AppendDocument chiamate o impostate SectionStart per NewPage.

**Come posso mantenere gli stili di destinazione durante l’importazione?**Utilizzo ImportFormatMode.UseDestinationStyles in AppendDocument.

**Vuoi aggiornare automaticamente i numeri di pagina e TOC?**Chiamate UpdateFields() (e UpdatePageLayout() per pagine precise) dopo tutti gli appendenti.

**Posso mescolare le entrate crittografate e produrre le uscite incriptate?**Sì, forniamo LoadOptions.Password per gli ingressi e l’utilizzo PdfSaveOptions.EncryptionDetails (o OoxmlSaveOptions.Password) per la produzione.

**È necessario un ufficio?**No. Aspose.Words è una biblioteca indipendente.

 Italiano