Aspose.Words dokumentu apvienošana .NET

Aspose.Words Document Merger for .NET ļauj jums programmatiski pievienot jebkādu dokumentu skaitu, kas ir saderīgi ar Word vienā izdevumā, saglabājot formātu, stilu, lapu izkārtojumu, virsrakstus/pēterus un laukumus.

Darbojas bezgalīgi Windows, Linux un macOS. nav nepieciešama Microsoft Office.

Instalācija un uzstādīšana

  • Instalēt NuGet paketi Aspose.Words.
  • Pielietojiet mērenu licencēšanu lietojumprogrammas start-up, lai izvairītos no novērtēšanas ūdensrādītājiem. skatīt Metered Licensing .
  • Pārbaudiet sistēmas prasības Installation Guide .

Atbalstīti ieejas (izvēlēti): DOC, DOCX, DOTX/DOTM, RTF, ODT, HTML/MHTML, PDF, TXT, WordML.Atbalstīti iznākumi: DOCX, DOC, PDF, HTML (fiksēts / plūsma), MHTML, ODT, RTF, attēli, EPUB, XPS un vairāk.

Ātrs sākums: pievienojiet vairākus dokumentus 

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

Importa formāta modeļi

  • KeepSourceFormatting – saglabā katra avota stili un tiešo formatēšanu (ideāli piemērots marķētajiem ievadījumiem).
  • UseDestinationStyles — kartē identiskus stila nosaukumus galamērķa definīcijām, lai nodrošinātu vienotu izskatu.

Pārbaudīta sadaļa un lapas izklāsts

Sāciet katru dokumentu ar Jaunā lapa, Pastāvīga vai Even/Odd Page:

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

Unify margins / lapas izmērs, kopējot PageSetup No šablona sadaļas:

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

Galvassāpes, kājas un ūdens zīmes

Saglabājiet avotu vārdus / pēdas, vai aizstāt tos ar galveno sadaļu pēc apvienošanas:

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

Lauki, pārrobežu atsauces un TOC

Pēc apvienošanās, atjaunināt lapas, lai lapu numuri, atsauces un Tabela saturs atbilstu jaunajam izkārtojumam:

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

Ja saglabājat vienu Masters TOC, ievadiet to vienu reizi un ļaujiet to automātiski atgūt:

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

Password-Protected Inputs un Secure Output 

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

Stream-First / 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
}

Darbības tips

  • Batch piestiprina atmiņā; zvanīt UpdateFields() Vienu reizi beigās.
  • Izvēlieties UseDestinationStyles, ja vēlaties konsekventi stilizēt vairākus desmitus ieejas.
  • Dispose Document gadījumi agrīnā laikā garos caurulēs, lai samazinātu pīķa atmiņu.

Pārvaldīt sajauktos formātus (HTML, PDF, TXT)

  • HTML/MHTML: imports ar stiliem un attēliem (saistīts vai iebūvēts).
  • PDF: lapas tiek importētas kā pārstrādāts saturs, ja iespējams; sarežģītās izkārtojumi tiek saglabāti izdošanas laikā fiksētos formātos (piemēram, PDF).
  • TXT: piestiprināts kā taisnās daļas; pēc importēšanas piemēro pamata stilu, lai nodrošinātu konsekvenci.

Labākās prakses

  • Pre-validate par korupciju / paroles, lai izvairītos no daļējiem apvienojumiem.
  • Izvēlieties KeepSourceFormatting, kad zīmola lojalitāte ir svarīga; izvēlēties UseDestinationStyles vienādai izskatu.
  • Ievadiet sekcijas pārtraukumu pirms katras pielikuma, lai aizsargātu lapas iestatījumus.
  • Savienojiet galvassāpes / pēdas pēc uzklāšanas, ja vēlaties vienu uzņēmuma veidni.
  • Apstipriniet laukumus un TOC kā pēdējo soli.
  • Ļoti lieliem spēkiem sadalīt grupās un apvienot grupas, lai saglabātu atmiņu stabilu.

FAQ

**Vai es varu piespiest katru avotu sākt ar jaunu lapu?**Jā. Ievadiet sadaļu vai lapas pārtraukumu pirms katras AppendDocument Zvanīt vai iestatīt SectionStart Lai NewPage.

**Kā es saglabāju galamērķa stili importēšanas laikā?**Use ImportFormatMode.UseDestinationStyles Iekšējā AppendDocument.

**Vēlaties automātiski atjaunināt lapas numurus un TOC?**Call UpdateFields() (un UpdatePageLayout() par precīzu pagināciju) pēc visiem apģērbiem.

**Vai es varu apvienot šifrētus ieejas un ražot sīpolu?**Jā, nodrošiniet LoadOptions.Password Ieeja un lietošana PdfSaveOptions.EncryptionDetails (vai OoxmlSaveOptions.Password) par produkciju.

**Vai birojs ir vajadzīgs?**No. Aspose.Words ir atsevišķa bibliotēka.

 Latviski