Συγχωνευτής εγγράφων 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 (fixed/flow), 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
Εάν διατηρείτε ένα ενιαίο Master TOC, εισάγετε το μία φορά και αφήστε το να επαναληφθεί αυτόματα:
var b = new DocumentBuilder(master);
b.MoveToDocumentStart();
b.InsertTableOfContents("TOC \o \h \z \u"); // classic TOC switch set
master.UpdateFields();
Προστατευμένες εισαγωγές κωδικού πρόσβασης & Safe 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 Μέρκερ
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
}
Τύποι απόδοσης
- Batch appends στη μνήμη; κλήση
UpdateFields()
Μια φορά στο τέλος. - Προτιμάτε UseDestinationStyles όταν θέλετε συνεπή στυλ σε δεκάδες εισαγωγές.
- Dispose
Document
έγκαιρες περιπτώσεις σε μακρύς σωλήνες για να μειωθεί η μνήμη κορυφής.
Διαχείριση μεικτών μορφών (HTML, PDF, TXT)
- HTML/MHTML : εισαγωγές με στυλ και εικόνες (συνδεδεμένες ή ενσωματωμένες).
- PDF : Οι σελίδες εισάγονται ως επανασυσκευασμένο περιεχόμενο όπου είναι δυνατόν. οι σύνθετες διατάξεις διατηρούνται κατά τη διάρκεια της έκδοσης σε σταθερές μορφές (π.χ. PDF).
- TXT : προστίθεται ως απλές παραγράφους. εφαρμόστε ένα βασικό στυλ μετά την εισαγωγή για συνέπεια.
שיטות עבודה מומלצות
- Προ-εξυγίανση για διαφθορά / κωδικούς πρόσβασης για την αποφυγή μερικών συγχωνεύσεων.
- Επιλέξτε **KeepSourceFormatting ** όταν η εμπιστοσύνη του εμπορικού σήματος έχει σημασία. επιλέγοντας UseDestinationStyles για ομοιόμορφη εμφάνιση.
- Εισάγετε ένα section break πριν από κάθε προσθήκη για να προστατεύσετε τη ρύθμιση της σελίδας.
- Συνδέστε τα κεφάλια / τα πόδια μετά την εμφάνιση εάν θέλετε ένα ενιαίο πρότυπο εταιρείας.
- Καταβάστε τα πεδία & TOC ως το τελικό βήμα.
- Για πολύ μεγάλες μπάτσες, χωρίστε σε ομάδες και συγχωνεύστε τις ομάδας για να διατηρήσετε τη μνήμη σταθερή.
FAQ
**Μπορώ να αναγκάσω κάθε πηγή να ξεκινήσει σε μια νέα σελίδα?**Εισάγετε ένα τμήμα ή διάλειμμα σελίδας πριν από κάθε AppendDocument
Καλέστε ή καθορίστε SectionStart
Για NewPage
.
**Πώς μπορώ να διατηρώ τα στυλ προορισμού κατά την εισαγωγή?**Χρήση ImportFormatMode.UseDestinationStyles
Σε AppendDocument
.
**Θέλετε να ενημερώσετε αυτόματα τους αριθμούς σελίδων και το TOC?**Κλήσεις UpdateFields()
(και UpdatePageLayout()
για ακριβή σελίδα) μετά από όλες τις εφαρμογές.
**Μπορώ να συγχωνεύσω κρυπτογραφημένες εισόδους και να παράγω κρύβονται έσοδα?**Ναι, προσφέρετε LoadOptions.Password
Για εισαγωγές και χρήση PdfSaveOptions.EncryptionDetails
(ή OoxmlSaveOptions.Password
) για την παραγωγή.
**Είναι απαραίτητο το γραφείο?**No. Aspose.Words είναι μια ξεχωριστή βιβλιοθήκη.