Aspose.Words Объединитель документов для .NET

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

Работает безглавно на Windows, Linux и macOS. Не требуется Microsoft Office.

Инсталляция и установка

  • Настройка пакета NuGet Aspose.Words.
  • Используйте мерную лицензию на стартапе приложений, чтобы избежать оценки водных знаков. Смотреть Metered Licensing .
  • Проверьте требования к рамкам в Инсталляционный водитель .

Поддержанные входы (выбранные): 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

Unify margins/page size посредством копирования 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);

Поток-первый / High-Volume Merges 

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 является самостоятельной библиотекой.

 Русский