Aspose.Words Combinador de Documentos para .NET

El **Aspose.Words Document Merger para .NET ** le permite programáticamente adjuntar cualquier número de documentos compatibles con Word en una única salida mientras conserva el formato, los estilos, el layout de la página, las titulares/footers, y los campos.

Funciona sin cabeza en Windows, Linux y macOS. No se requiere Microsoft Office.

Instalación y configuración

  • Instalar el paquete NuGet Aspose.Words.
  • Aplique la licencia medida en la startup de la aplicación para evitar las puntuaciones de evaluación. Ver Licencia mediada .
  • Verifique los requisitos de marco en el Guía de instalación .

Suported Inputs (selected): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Suportados resultados: DOCX, DOC, PDF, HTML (fixt/flow), MHTML, ODT, RTF, imágenes, EPUB, XPS, y más.

Inicio Rápido: Añadir varios documentos 

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

Modos de importación

  • KeepSourceFormatting – conserva los estilos de cada fuente y la formatación directa (ideal para insertos marcados).
  • UseDestinationStyles — mapas de nombres de estilo idénticos a las definiciones del destino para un aspecto uniforme.

Controlada Sección y Layout de Páginas

Inicio de cada documento en **Nueva Página ** , **Continuo ** o Even/Odd Page:

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

Unificar las margen / tamaño de la página mediante la copia PageSetup En una sección 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;
}

Cabezas, piezas y marcos de agua

Mantener las cabezas de fuente/footers, o reemplazarlas con un conjunto maestro después de la fusión:

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

Los campos, las referencias cruzadas y el TOC

Después de la fusión, los campos de actualización para que los números de páginas, las referencias y Table de Contenidos coincidan con el nuevo diseño:

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

Si mantiene un solo TOC maestro, insertarlo una vez y deje que se recupere automáticamente:

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

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

El flujo-primero / Merges de alto volumen 

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
}

Tipos de rendimiento

  • Batch apendiza en la memoria; llamada UpdateFields() Una vez al final.
  • Preferir UseDestinationStyles cuando desea estilos consistentes a través de decenas de entradas.
  • Dispose Document instantes tempranas en los tubos largos para reducir la memoria de pico.

Gestión de formatos mixtos (HTML, PDF, TXT)

  • HTML/MHTML : importes con estilos y imágenes (linked o embedded).
  • PDF : las páginas se importan como contenido reflutado donde sea posible; los diseños complejos se conservan durante la salida a formatos fijos (por ejemplo, PDF).
  • TXT : añadido como párrafos platos; aplicar un estilo de base después de la importación para la coherencia.

Mejores Prácticas

  • Pre-valida para la corrupción / contraseñas para evitar fusiones parciales.
  • Seleccione **KeepSourceFormatting ** cuando la fidelidad de la marca es importante; elija UseDestinationStyles para un aspecto uniforme.
  • Insertar una brecha de sección antes de cada apéndice para proteger la configuración de la página.
  • Unify headers/footers después de apendinar si desea un único modelo corporativo.
  • Actualiza los campos y TOC como el paso final.
  • Para batallas muy grandes, divide en grupos y fuga los grupos para mantener la memoria estable.

FAQ

**Puedo obligar a cada fuente a comenzar en una nueva página?**Siguiente Entrada siguiente: Insertar una sección o página antes de cada una AppendDocument llamar o configurar SectionStart para NewPage.

**Cómo puedo mantener los estilos de destino mientras importa?**Uso ImportFormatMode.UseDestinationStyles En AppendDocument.

**Quieres que los números de página y TOC actualizen automáticamente?**llamadas UpdateFields() (y UpdatePageLayout() para la página exacta) después de todos los apendices.

**Puedo combinar entradas cifradas y producir salida cifrada?**Siguiente: Ofrece LoadOptions.Password para las entradas y el uso PdfSaveOptions.EncryptionDetails (o OoxmlSaveOptions.Password) para la producción.

**Es necesaria la Oficina?**No. Aspose.Words es una biblioteca independiente.

 Español