Εισαγωγή
Aspose.Words FOSS για .NET είναι τώρα διαθέσιμο: μια δωρεάν, ανοιχτού κώδικα βιβλιοθήκη .NET για δημιουργία, ανάγνωση και επεξεργασία εγγράφων Word σε καθαρό C#, χωρίς να απαιτείται εγκατάσταση του Microsoft Word. Στοχεύει σε προγραμματιστές που χρειάζονται να δημιουργούν αναφορές και επιστολές από πρότυπα, να διαβάζουν και να ανασυνθέτουν περιεχόμενο από υπάρχοντα αρχεία .docx, ή να μετατρέπουν έγγραφα Word σε Markdown ή απλό κείμενο ως μέρος μιας αλυσίδας επεξεργασίας, χωρίς την άδεια ενός εμπορικού SDK.
Η βιβλιοθήκη κυκλοφορεί υπό την άδεια MIT και δεν έχει εγγενείς εξαρτήσεις — όλα εκτελούνται σε διαχειριζόμενο κώδικα. Στοχεύει στο .NET Standard 2.0, έτσι λειτουργεί στο .NET Framework 4.6.2+ και στο .NET 6, 8 και 10, σε Windows, Linux και macOS. Εγκαταστήστε τη μέσω NuGet, ή δημιουργήστε τη βιβλιοθήκη από τον πηγαίο κώδικα με μια εντολή dotnet build (δείτε το Quick Start παρακάτω).
Αυτό που το διακρίνει από μια τυπική νέα ανοιχτού κώδικα βιβλιοθήκη εγγράφων είναι ότι δεν είναι ξαναγράψιμο ή περιτύλιγμα. Aspose.Words FOSS για .NET είναι η αυθεντική βάση κώδικα Aspose.Words — η ίδια μηχανή εγγράφων που επεξεργάζεται έγγραφα Word σε παραγωγή από το 2003 — μειωμένη σε ένα δωρεάν, με άδεια MIT πυρήνα. Οι προγραμματιστές που ξεπερνούν αυτήν την έκδοση και χρειάζονται διάταξη σελίδων, απόδοση ή τους επιπλέον μετατροπείς μορφών μπορούν να μεταβούν στο εμπορικό Aspose.Words για .NET χωρίς να ξαναγράψουν τον κώδικά τους, καθώς είναι το ίδιο υποκείμενο API.
Κύρια Χαρακτηριστικά
Δημιουργία και Επεξεργασία Εγγράφων
Δημιουργήστε έγγραφα από την αρχή με new Document() και το υψηλού επιπέδου DocumentBuilder, ή ανοίξτε υπάρχοντα αρχεία .docx με new Document(fileName). Το DocumentBuilder παρέχει διαδοχικές μεθόδους συγγραφής όπως Write(), Writeln(), InsertParagraph() και InsertBreak(), μαζί με ιδιότητες μορφοποίησης (Font, ParagraphFormat, PageSetup) που εφαρμόζονται στο περιεχόμενο κατά την εισαγωγή του. Για πρόσβαση χαμηλότερου επιπέδου, περιηγηθείτε απευθείας στο δέντρο του εγγράφου μέσω των κόμβων Section, Paragraph, Run και Table, ή δημιουργήστε υποκλάση του DocumentVisitor για να επεξεργαστείτε κάθε τύπο κόμβου σε μία μόνο διέλευση.
Πίνακες και Λίστες
Οι πίνακες δημιουργούνται από κόμβους Table, Row και Cell. Οι μέθοδοι Table.SetBorders(), Table.SetShading() και Table.AutoFit() μορφοποιούν ολόκληρο τον πίνακα ταυτόχρονα, ενώ η πρόσβαση σε Table.Rows και σε κάθε Cell ανά σειρά προσφέρει πιο λεπτομερή έλεγχο. Οι αριθμημένες και με κουκίδες λίστες περνούν μέσω ListCollection και ListFormat: εφαρμόστε ένα ενσωματωμένο στυλ με ListFormat.ApplyBulletDefault() ή ApplyNumberDefault(), ή καταχωρήστε έναν προσαρμοσμένο ορισμό λίστας με ListCollection.Add().
Αλλαγές με Παρακολούθηση και Προστασία Εγγράφου
Καλέστε Document.StartTrackRevisions() πριν από την επεξεργασία για να καταγράψετε εισαγωγές, διαγραφές και αλλαγές μορφοποίησης, στη συνέχεια ελέγξτε, αποδεχτείτε ή απορρίψτε τις μέσω του RevisionCollection (AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria)), ή αποδεχτείτε όλα ταυτόχρονα με το Document.AcceptAllRevisions(). Το Document.Protect() εφαρμόζει προστασία με κωδικό πρόσβασης ή επιβολή μόνο για ανάγνωση χρησιμοποιώντας την απαρίθμηση DocumentSecurity (ReadOnlyEnforced, ReadOnlyRecommended, PasswordProtected και σχετικές τιμές), και το Document.Unprotect() αντιστρέφει αυτό.
Πεδία, Μακροεντολές και Ψηφιακές Υπογραφές
Η μηχανή αξιολόγησης πεδίων ενημερώνει πεδία όπως το FieldDate (το πεδίο DATE) και το FieldDocProperty (το πεδίο DOCPROPERTY) επί τόπου μέσω του Document.UpdateFields() — πεδία που εξαρτώνται από τη διάταξη σελίδας, όπως οι αριθμοί σελίδων, αξιολογούνται σε τιμές κράτησης θέσης επειδή η διάταξη σελίδας δεν αποτελεί μέρος αυτής της έκδοσης. Τα αρχεία DOCM και DOTM διατηρούν τα VBA projects τους αμετάβλητα κατά το round‑trip. Οι υπάρχουσες ψηφιακές υπογραφές μπορούν να ελεγχθούν μέσω του DigitalSignatureCollection και του DigitalSignature (IsValid, SubjectName, IssuerName, SignTime) για να επιβεβαιωθεί εάν ένα έγγραφο είναι υπογεγραμμένο και δεν έχει παραβιαστεί· η δημιουργία νέων υπογραφών δεν είναι μέρος αυτής της έκδοσης.
Διαγράμματα
Εισάγετε ένα γράφημα σε ένα έγγραφο με το DocumentBuilder.InsertChart(), στη συνέχεια διαμορφώστε τις σειρές δεδομένων του μέσω του αντικειμένου Chart που επιστρέφεται.
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Γρήγορη Έναρξη
Aspose.Words FOSS για .NET είναι διαθέσιμο μέσω NuGet:
dotnet add package Aspose.Words.FOSSΓια να κατασκευάσετε από τον πηγαίο κώδικα αντ’ αυτού:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release
Στη συνέχεια, προσθέστε μια αναφορά έργου στο Aspose.Words.csproj από την εφαρμογή σας. Με την αναφορά στη θέση της, δημιουργήστε ένα έγγραφο με γράφημα και αποθηκεύστε το σε DOCX:
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Console.WriteLine("Saved chart.docx");
Υποστηριζόμενες Μορφές
| Μορφοποίηση | Επέκταση | Ανάγνωση | Εγγραφή |
|---|---|---|---|
| DOCX | .docx | ✓ | ✓ |
| DOCM | .docm | ✓ | ✓ |
| DOTX | .dotx | ✓ | ✓ |
| DOTM | .dotm | ✓ | ✓ |
| Flat OPC (όλες οι παραλλαγές) | (διάφορα) | ✓ | ✓ |
| Markdown | .md | ✓ | ✓ |
| Text | .txt | ✓ | ✓ |
Αυτή η έκδοση εξαιρεί σκόπιμα τη διάταξη σελίδας και την απόδοση — δεν υπάρχει εξαγωγή σε PDF, XPS ή εικόνα, και δεν υπάρχει εκτύπωση, κάτι που σημαίνει επίσης ότι οι τιμές πεδίων που εξαρτώνται από τη διάταξη, όπως οι αριθμοί σελίδων, αξιολογούνται ως σύμβολα κράτησης θέσης αντί να υπολογίζονται. Οι πρόσθετοι μετατροπείς μορφών (DOC, RTF, ODT, HTML, EPUB, MHTML, MOBI, AZW3 και WordML) δεν διαβάζονται ή γράφονται, και η εκτέλεση συγχώνευσης αλληλογραφίας, η αναφορά LINQ, η σύγκριση εγγράφων, η δημιουργία νέων ψηφιακών υπογραφών και η υποσύνολο ενσωματωμένων γραμματοσειρών δεν περιλαμβάνονται. Αυτά είναι τα ίδια υποσυστήματα που αφαιρεθήκαν από τον εμπορικό κώδικα για να διατηρηθεί αυτή η έκδοση δωρεάν.
Ανοιχτός Κώδικας & Άδειες
Aspose.Words FOSS για .NET κυκλοφορεί υπό την άδεια MIT, δωρεάν τόσο για εμπορική όσο και για προσωπική χρήση, χωρίς δικαιώματα ή περιορισμούς διανομής. Ο πλήρης κώδικας είναι διαθέσιμος στο GitHub στο Aspose.Words FOSS για .NET αποθετήριο.
