Dokumentum Egyesítő

A Aspose.Words Document Merger for .NET programozott módon engedélyezi összevonja a Word‑compatible dokumentumok tetszőleges számát egyetlen kimenetbe, miközben megőrzi a formázást, stílusokat, oldalelrendezést, fejléceket/lábléceket és mezőket. Tipikus felhasználások közé tartozik jelentések összeállítása, szerződéses mellékletek csomagolása, vagy a generált tartalom archiválásra történő összegyűjtése.

Fej nélküli módon működik Windows, Linux és macOS rendszereken. Microsoft Office nem szükséges.

Telepítés és beállítás

  1. Telepítse a NuGet csomagot Aspose.Words.
  2. Alkalmazzon metered licensing-et az alkalmazás indításakor, hogy elkerülje az evaluation watermarks-ot. Lásd Mérői licencelés .
  3. Ellenőrizze a keretrendszer követelményeit a Telepítési útmutató .

IDE-k: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

Támogatott bemenetek / kimenetek: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML, és Word 2007 XML.

Gyors kezdés: Több dokumentum hozzáfűzése 

using Aspose.Words;

var master = new Document();
var builder = new DocumentBuilder(master);

builder.InsertBreak(BreakType.SectionBreakNewPage);

ImportFormatMode mode = ImportFormatMode.KeepSourceFormatting;

foreach (string path in new[] { "Blank.docx", "Background images.docx", "annex.rtf" })
{
    var src = new Document(path);
    master.AppendDocument(src, mode);
    builder.MoveToDocumentEnd();
    builder.InsertBreak(BreakType.SectionBreakNewPage);
}

master.UpdateFields();
master.Save("MergedOutput.docx");

Import Formátum Módok:

  • KeepSourceFormatting — megőrzi minden forrás stílusait és közvetlen formázását (ideális a márkás betétekhez).
  • UseDestinationStyles — azonos stílusneveket a cél definícióihoz rendeli a egységes megjelenés érdekében.

Vezérelt szakasz és oldalelrendezés

Kezdje minden dokumentumot a Új oldal, Folyamatos, vagy Páros/páratlan oldal:

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

Margók/oldalméret egységesítése másolással PageSetup sablon szakaszból:

using Aspose.Words;
var master = new Document();

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

Fejlécek, láblécek és vízjelek

Tartsa meg a forrás fejléceit/lábléceit, vagy cserélje le őket egy mesterkészletre az egyesítés utá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);
}

Mezők, kereszt‑hivatkozások és TOC

Az egyesítés után frissítse a mezőket, hogy az oldalszámok, hivatkozások és Tartalomjegyzék illeszd a új elrendezéshez:

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

Ha egyetlen mester TOC-ot tart fenn, szúrja be egyszer, és hagyja, hogy automatikusan újraépüljön.:

using Aspose.Words;
var master = new Document();

var b = new DocumentBuilder(master);
b.MoveToDocumentStart();
b.InsertTableOfContents("TOC \\$1 \\$1 \\$1 \\$1");  // classic TOC switch set
master.UpdateFields();

Stream‑First / Nagy mennyiségű egyesítések 

using System.IO;
using System.Collections.Generic;
using Aspose.Words;
using Aspose.Words.Lists;

IEnumerable<Stream> sourceStreams = new List<Stream>();

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.docx);
    output.Position = 0;
    // return/output stream
}

Teljesítmény tippek:

  • Kötegelt hozzáfűzések a memóriában; hívd UpdateFields() egyszer a végén.
  • Részesítsd előnyben UseDestinationStyles ha konzisztens stílusra van szükséged tucatnyi bemenet esetén.
  • Felszabadít Document példányokat korán a hosszú csővezetékekben a csúcs memória csökkentése érdekében.

Legjobb gyakorlatok

  • Elő‑ellenőriz a sérülés/jelszavak ellen, hogy elkerüljük a részleges egyesítéseket.
  • Válassz KeepSourceFormatting amikor a márkahűség számít; válassz UseDestinationStyles az egységes megjelenésért.
  • Helyezzen be egy szakaszváltás minden hozzáfűzés előtt a lapbeállítás védelme érdekében.
  • Fejlécek/láblécek egységesítése a hozzáfűzés után, ha egyetlen vállalati sablont szeretne.
  • Mezők és tartalomjegyzék frissítése az utolsó lépésként.
  • Nagyon nagy kötegek esetén oszd fel csoportokra, és egyesítsd a csoportokat a memória stabilitásának megőrzése érdekében.

FAQ

  1. Kényszeríthetem, hogy minden forrás új oldalon kezdődjön? Igen. Helyezzen be egy szakasz- vagy oldaltörést minden egyes előtt AppendDocument hívás vagy beállítás SectionStart ra NewPage.
  2. Hogyan őrizhetem meg a cél stílusait importáláskor? Használja ImportFormatMode.UseDestinationStyles ban AppendDocument.
  3. A lapok számai és a tartalomjegyzék automatikusan frissülnek? Hív UpdateFields() (és UpdatePageLayout() a pontos lapozáshoz) az összes hozzáfűzés után.
  4. Szükséges az Office? Nem. Aspose.Words egy önálló könyvtár.
 Magyar