Aspose.Words ドキュメントマージャー for .NET

Aspose.Words Document Merger for .NET は、フォーマット、スタイル、ページランキング、ヘッダー/フォーター、およびフィールドを保存しながら、単一の出力にプログラミング的にWord-compatible ドキュメントのいずれかの数を追加することを可能にします.

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(固定/流れ)、MHP、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 - ユニークな外観のために目的地の定義と同一のスタイル名をマップします.

コントロールセクション&ページランキング

各ドキュメントを New Page 、 Continuous または Even/Odd Pageからスタートさせます:

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

ストリーム・ファースト/ハイ・ボリューム 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() 最後に1回.
  • 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) 出力のために.

**オフィスは必要ですか?**ASPOSE.Wordsは独自の図書館です.

 日本語