Aspose.Words Об'єднання документів для .NET

Aspose.Words Document Merger для .NET дозволяє програматично приєднувати будь-яку кількість Word-сумісних документів до одного виходу, зберігаючи форматування, стилі, розташування сторінки, заголовки / ноги та поля.

Працює безперервно на Windows, Linux і macOS. Не потрібен Microsoft Office.

Інсталяція та установка

  • Завантажити пакет NuGet Aspose.Words.
  • Використовуйте розмірну ліцензію на стартапі додатків, щоб уникнути оцінки водних знаків. переглянути Metered Licensing .
  • Перевірте рамкові вимоги в [Інсталяційний посібник] https://docs.aspose.net/words/getting-started/installation/ ).

Підтримуються входи (вибрані): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Підтримуються виходи: DOCX, DOC, PDF, HTML (фіксований / поточний), MHTML, ODT, RTF, зображення, EPUB, XPS і багато іншого.

Швидкий старт: додаток до кількох документів 

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

Формат імпорту

  • KeepSourceFormatting — зберігає стилі кожного джерела і прямий формат (ідеальний для брендованих встав).
  • UseDestinationStyles — карта ідентичних назв стилю до визначень місця призначення для однорідного вигляду.

Контрольована секція та розташування сторінки

Почніть кожен документ на **Нова сторінка ** , **Постійний ** або Додайте сторінку:

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

Об’єднання маргінів / розмірів сторінки шляхом копіювання PageSetup З розділу шаблону:

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, введіть його один раз і дозвольте його автоматично відновити:

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

Пароль-захищений вхід і безпечний вихід 

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

Потік-перший / Високий обсяг 

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
}

Використання результатів

  • Батч прикріплюється в пам’яті; дзвінок UpdateFields() Одного разу в кінці.
  • Краще UseDestinationStyles , коли ви хочете постійного стилювання через десятки входів.
  • Dispose Document Ранні приклади в довгих трубопроводах, щоб зменшити пік пам’яті.

Обробка змішаних форматів (HTML, PDF, TXT)

  • HTML/MHTML : імпорт зі стилями і зображеннями (пов’язаний або вбудований).
  • PDF : сторінки імпортуються як повторний вміст, коли це можливо; складні розташування зберігаються під час виходу до фіксованих форматів (наприклад, PDF).
  • TXT : додано як прямі абзаци; застосовується базовий стиль після імпорту для послідовності.

Найкращі практики

  • Пред-визначення для корупції / паролів для уникнення часткових поєднань.
  • Виберіть **KeepSourceFormatting ** , коли довіра до бренду важлива; вибрати UseDestinationStyles для однорідного вигляду.
  • Перед кожним додатком введіть ** секційну перерву** , щоб захистити налаштування сторінки.
  • Уніфікуйте головки / ноги після завантаження, якщо ви хочете єдиного корпоративного шаблону.
  • Оновлення полів & TOC як кінцевий крок.
  • Для дуже великих боїв, розділіть на групи і поєднуйте групи, щоб зберегти пам’ять стабільною.

FAQ

**Чи можу я змусити будь-який джерело починати з нової сторінки?**Введіть розділ або розрив сторінки перед кожним AppendDocument Зателефонуйте або налаштуйте SectionStart до NewPage.

**Як я зберігаю стилі призначення під час імпорту?**Користувати ImportFormatMode.UseDestinationStyles в AppendDocument.

**Хочеться автоматично оновлювати номери сторінки та TOC?**Зателефонуйте UpdateFields() (і UpdatePageLayout() Попередня статтяКто чего не ест.

**Чи можу я поєднувати зашифровані входи і виробляти криптовалютний вихід?**Пропонуємо LoadOptions.Password для введення та використання PdfSaveOptions.EncryptionDetails (або OoxmlSaveOptions.Password) для видобутку.

**Чи потрібен офіс?**No. Aspose.Words є самостійною бібліотекою.

 Українська