ตัวผสานเอกสาร

The Aspose.Words Document Merger for .NET ทำให้คุณสามารถเขียนโปรแกรมเพื่อ รวมเอกสาร Word‑compatible จำนวนใดก็ได้ เป็นผลลัพธ์เดียวขณะคงรูปแบบ, สไตล์, การจัดหน้า, ส่วนหัว/ส่วนท้าย, และฟิลด์ไว้. การใช้งานทั่วไปรวมถึงการจัดทำรายงาน, การรวมเอกสารแนบสัญญา, หรือการรวบรวมเนื้อหาที่สร้างขึ้นเพื่อการเก็บถาวร.

ทำงานแบบไม่มี UI บน Windows, Linux, และ macOS ไม่ต้องใช้ Microsoft Office.

การติดตั้งและตั้งค่า

  1. ติดตั้งแพคเกจ NuGet Aspose.Words.
  2. ใช้ metered licensing ที่การเริ่มต้นแอปเพื่อหลีกเลี่ยงลายน้ำการประเมินผล. ดู Metered Licensing .
  3. ตรวจสอบข้อกำหนดของเฟรมเวิร์กใน the คู่มือการติดตั้ง .

IDEs: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

อินพุต / เอาต์พุตที่รองรับ: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML, และ Word 2007 XML.

Quick Start: ต่อหลายเอกสาร

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

โหมดรูปแบบการนำเข้า:

  • KeepSourceFormatting — รักษาสไตล์และการจัดรูปแบบโดยตรงของแต่ละแหล่ง (เหมาะสำหรับการแทรกแบรนด์).
  • UseDestinationStyles — แมปชื่อสไตล์ที่เหมือนกันไปยังคำนิยามของปลายทางเพื่อให้รูปลักษณ์สม่ำเสมอ.

ส่วนที่ควบคุมและการจัดหน้า

เริ่มแต่ละเอกสารที่ หน้าใหม่, ต่อเนื่อง, หรือ หน้าเลขคู่/เลขคี่:

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

ทำให้ขอบ/ขนาดหน้าเป็นหนึ่งเดียวโดยการคัดลอก PageSetup จากส่วนของเทมเพลต:

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

ส่วนหัว, ส่วนท้าย, และลายน้ำ

คงส่วนหัว/ส่วนท้ายของแหล่งต้นฉบับ, หรือแทนที่ด้วยชุดหลักหลังการรวม:

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

ฟิลด์, การอ้างอิงข้าม, และสารบัญ (TOC)

หลังจากการรวมแล้ว ให้อัปเดตฟิลด์เพื่อให้หมายเลขหน้า, การอ้างอิง, และ สารบัญ ตรงกับเค้าโครงใหม่:

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

ถ้าคุณดูแล TOC หลักเดียว, แทรกมันครั้งเดียวและให้มันสร้างใหม่อัตโนมัติ:

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 / High‑Volume Merges

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
}

เคล็ดลับประสิทธิภาพ:

  • เพิ่มข้อมูลเป็นชุดในหน่วยความจำ; เรียก UpdateFields() หนึ่งครั้งที่ส่วนท้าย.
  • เลือกใช้ UseDestinationStyles เมื่อคุณต้องการการจัดรูปแบบที่สอดคล้องกันในหลายสิบอินพุต.
  • กำจัด Document อินสแตนซ์ตั้งแต่ต้นในไพป์ไลน์ยาวเพื่อ ลดการใช้หน่วยความจำสูงสุด.

แนวทางปฏิบัติที่ดีที่สุด

  • ตรวจสอบล่วงหน้า เพื่อป้องกันความเสียหาย/รหัสผ่านเพื่อหลีกเลี่ยงการผสานบางส่วน.
  • เลือก KeepSourceFormatting เมื่อความแม่นยำของแบรนด์สำคัญ; เลือก UseDestinationStyles เพื่อให้รูปลักษณ์สม่ำเสมอ.
  • แทรก a การแบ่งส่วน ก่อนการต่อเติมแต่ละครั้งเพื่อปกป้องการตั้งค่าหน้า.
  • ทำให้ส่วนหัว/ส่วนท้ายเป็นแบบเดียวกัน หลังจากต่อท้าย หากคุณต้องการเทมเพลตองค์กรแบบเดียว.
  • อัปเดตฟิลด์ & TOC เป็นขั้นตอนสุดท้าย.
  • สำหรับชุดข้อมูลขนาดใหญ่มาก ให้แยกเป็นกลุ่มและรวมกลุ่มเหล่านั้นเพื่อรักษาให้หน่วยความจำคงที่.

FAQ

  1. ฉันสามารถบังคับให้แหล่งข้อมูลทุกอันเริ่มต้นบนหน้าใหม่ได้หรือไม่? ใช่. แทรกส่วนหรือการแบ่งหน้า ก่อนแต่ละ AppendDocument การเรียกหรือการตั้งค่า SectionStart เพื่อ NewPage.
  2. ฉันจะคงสไตล์ของปลายทางไว้ขณะนำเข้าได้อย่างไร? ใช้ ImportFormatMode.UseDestinationStyles ใน AppendDocument.
  3. หมายเลขหน้าและสารบัญจะอัปเดตโดยอัตโนมัติหรือไม่? เรียก UpdateFields() (และ UpdatePageLayout() เพื่อการแบ่งหน้าอย่างแม่นยำ) หลังจากการต่อทั้งหมด.
  4. ต้องการ Office หรือไม่? ไม่, Aspose.Words เป็นไลบรารีแบบสแตนด์อโลน.
 แบบไทย