Fusionador de Documentos Aspose.Words para .NET

O **Aspose.Words Document Merger para .NET ** permite que você programaticamente conecte qualquer número de documentos compatíveis com o Word em uma única saída, ao mesmo tempo que preserva formatação, estilos, layout de página, cabeçalhos/footers e campos. Usos típicos incluem relatórios de montagem, exposições de contrato de pacote ou agregando conteúdo gerado para arquivamento.

Funciona sem cabeçalho em Windows, Linux e macOS. Não é necessário Microsoft Office.

Instalação e Setup

  • Instale o pacote NuGet Aspose.Words.
  • Aplique uma licença mediada no aplicativo startup para evitar os padrões de avaliação. ver Licença Mediada .
  • Verifique os requisitos de quadro no Guia de instalação .

Suported Inputs (selected): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Outputos suportados: DOCX, DOC, PDF, HTML (fixo/fluxo), MHTML, ODT, RTF, imagens, EPUB, XPS e muito mais.

Início rápido: adicionar vários 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");

Modo de Importação

  • KeepSourceFormatting – preserva os estilos de cada fonte e a formatação direta (ideal para inserções marcadas).
  • UseDestinationStyles – mapa nomes de estilo idênticos às definições do destino para uma aparência uniforme.

Secção controlada e layout de página

Comece cada documento com **Nova Página ** , **Continuo ** ou Even/Odd Page:

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

Unificar margens / tamanho de página através da cópia PageSetup Em uma seção 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;
}

Cabeças, Footers e Watermarks

Mantenha os cabeçalhos de fonte/footers, ou substitua-os com um conjunto de mestres após a fusão:

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

Campos, referências cruzadas e TOC

Após a fusão, os campos de atualização para que os números de páginas, referências e Tabela de Conteúdos correspondam ao novo layout:

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

Se você manter um único TOC mestre, insira-o uma vez e deixe que ele se recupere 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 Safe 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);

Fluxo-Primeiro / Merges de Alto Volume 

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 desempenho

  • Batch apêndidas na memória; chamada UpdateFields() Uma vez no fim.
  • Prefer UseDestinationStyles quando você quer estilos consistentes em dezenas de entradas.
  • Dispose Document instâncias cedo em tubos longos para reduzir a memória pico.

Processamento de Formatos Misturados (HTML, PDF, TXT)

  • HTML/MHTML : importações com estilos e imagens (linked ou embedded).
  • PDF : as páginas são importadas como conteúdo reflutado quando possível; layouts complexos são preservados durante a saída para formatos fixos (por exemplo, PDF).
  • TXT : adicionado como parágrafos planos; aplicar um estilo de base após a importação para consistência.

Melhores Práticas

  • Pre-valida para corrupção / senhas para evitar fusões parciais.
  • Escolha **KeepSourceFormatting ** quando a fidelidade da marca é importante; selecione UseDestinationStyles para uma aparência uniforme.
  • Insira uma section break antes de cada apêndice para proteger a configuração da página.
  • Unify headers/footers após a aplicação se você quiser um único modelo corporativo.
  • Actualiza os campos e TOC como o passo final.
  • Para batches muito grandes, divida em grupos e fuga os grupos para manter a memória estável.

FAQ

**Posso forçar cada fonte para começar em uma nova página?**Insira uma seção ou página quebra antes de cada AppendDocument Conversão ou Set SectionStart Para NewPage.

**Como posso manter os estilos de destino ao importar?**Utilização ImportFormatMode.UseDestinationStyles em AppendDocument.

**Quer que os números de página e TOC atualizem automaticamente?**Chamado UpdateFields() (e UpdatePageLayout() para a página exata) depois de todos os apendentes.

**Posso combinar entradas criptografadas e produzir output cifrado?**Sim, oferecemos LoadOptions.Password Para entradas e uso PdfSaveOptions.EncryptionDetails (ou OoxmlSaveOptions.Password) para a produção.

**O escritório é necessário?**No. Aspose.Words é uma biblioteca independente.

 Português