Δουλεύοντας με Ρυθμίσεις Εγγράφου
Εργασία με Ρυθμίσεις Εγγράφου
Πέρα από το περιεχόμενο, ένα έγγραφο Word περιέχει ρυθμίσεις σε επίπεδο εφαρμογής – διακόπτες συμβατότητας παλαιών εκδόσεων, προτιμήσεις συλλαβισμού, την αποθηκευμένη διαμόρφωση συγχώνευσης αλληλογραφίας, επιλογές προβολής και την κατάσταση προστασίας εγγραφής. Aspose.Words FOSS για .NET εκθέτει αυτά μέσω του Aspose.Words.Settings χώρου ονομάτων και μιας σειράς ιδιοτήτων στο Document. Η σελίδα αυτή καλύπτει κάθε ομάδα ρυθμίσεων και τι ελέγχει και τι δεν ελέγχει.
Επιλογές Συμβατότητας
Document.CompatibilityOptions είναι μια παρουσία CompatibilityOptions που περιέχει δεκάδες λογικούς διακόπτες που αναπαράγουν συγκεκριμένες συμπεριφορές διάταξης και απόστασης παλαιότερων εκδόσεων του Word — για παράδειγμα GrowAutofit, UseWord2010TableStyleRules, UseWord2002TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage, SpacingInWholePoints, UseFELayout και BalanceSingleByteDoubleByteWidth. Ορίστε απευθείας τις ιδιότητες που χρειάζεστε για να ταιριάζουν με τις ιδιαιτερότητες απόδοσης μιας συγκεκριμένης έκδοσης του Word στα επόμενα εργαλεία που διαβάζουν το έγγραφο.
Προτιμήσεις Συλλαβισμού
Document.HyphenationOptions είναι μια παρουσία HyphenationOptions (AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps, HyphenationZone) που αποθηκεύει τις προτιμήσεις συλλαβισμού του Word για το έγγραφο. Αυτές οι ιδιότητες διασχίζουν το αίτημα· επειδή αυτή η έκδοση δεν περιλαμβάνει τη μηχανή διάταξης σελίδων, το Aspose.Words FOSS δεν υπολογίζει μόνο του τις διακοπές συλλαβισμού — το Word τις εφαρμόζει όταν ανοίγει και σελιδοποιεί το αρχείο.
Διαμόρφωση Συγχώνευσης Αλληλογραφίας
Document.MailMergeSettings είναι ένα MailMergeSettings αντικείμενο που αποθηκεύει τη διαμόρφωση συγχώνευσης αλληλογραφίας που καταγράφηκε στο έγγραφο: MainDocumentType, CheckErrors, Destination, DataSource, DataType, Query, ConnectString, MailSubject, MailAsAttachment, ActiveRecord και ViewMergedData, καθώς και Clear() και Clone(). Για εξωτερικές πηγές δεδομένων που συνδέονται μέσω του μηχανισμού Office Data Source Object του Word, το MailMergeSettings.Odso εκθέτει ένα Odso αντικείμενο (DataSource, DataSourceType, TableName, ColumnDelimiter, FirstRowContainsColumnNames) του οποίου το FieldMapDatas (OdsoFieldMapDataCollection του OdsoFieldMapData: Name, MappedName, Column, Type) και το RecipientDatas (OdsoRecipientDataCollection του OdsoRecipientData: Active, Column, Hash, UniqueTag) περιγράφουν τη χαρτογράφηση πεδίων και τη λίστα παραληπτών.
Ρυθμίσεις Προβολής Εγγράφου
Document.ViewOptions είναι ένα ViewOptions αντικείμενο που ελέγχει τον τρόπο με τον οποίο το Word εμφανίζει το αρχείο όταν ανοίγεται: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries και FormsDesign. Αυτές οι ιδιότητες επηρεάζουν μόνο την εμφάνιση του εγγράφου από το Word — δεν έχουν καμία επίδραση στο πώς το Aspose.Words FOSS επεξεργάζεται το αρχείο.
Προστασία Εγγραφής
Document.WriteProtection είναι ένα WriteProtection αντικείμενο (IsWriteProtected, ReadOnlyRecommended) με SetPassword() για τον καθορισμό κωδικού προστασίας και ValidatePassword() για τον έλεγχο ενός υποψήφιου κωδικού έναντι αυτού.
Μονάδες Μέτρησης
Η απαρίθμηση MeasurementUnits καθορίζει τη μονάδα μέτρησης που πρέπει να χρησιμοποιεί το Word στη διεπαφή του για ένα έγγραφο.
Συμβουλές και Καλές Πρακτικές
CompatibilityOptions.OptimizeFor(MsWordVersion)είναι παρόν στην κλάση αλλά η υλοποίησή του δεν είναι ολοκληρωμένη σε αυτήν την έκδοση – πετάειNotImplementedException. Ορίστε τις μεμονωμένες boolean ιδιότητεςCompatibilityOptionsπου χρειάζεστε απευθείας αντί να βασίζεστε στοOptimizeForγια να εφαρμόσετε ολόκληρο προφίλ έκδοσης μονομιάς.MailMergeSettingsandOdsoαποθηκεύει τη συγχώνευση αλληλογραφίας configuration που καταγράφηκε στο έγγραφο – η ανάγνωση και η εγγραφή αυτής της διαμόρφωσης υποστηρίζονται, αλλά η εκτέλεση μιας συγχώνευσης αλληλογραφίας (συμπλήρωση πεδίων από ζωντανή πηγή δεδομένων) δεν περιλαμβάνεται σε αυτήν την έκδοση ανοιχτού κώδικα.HyphenationOptionsκαιViewOptionsείναι και οι δύο προτιμήσεις εμφάνισης/UI που εφαρμόζει το Word – μην περιμένετε ότι η κλήση τουDocument.Save()θα αλλάξει τον τρόπο περιτύλιξης ή εμφάνισης του κειμένου βάσει αυτών των ρυθμίσεων, καθώς αυτή η έκδοση δεν περιλαμβάνει τη μηχανή διάταξης σελίδας.- Καλέστε το
WriteProtection.SetPassword()πριν ενεργοποιήσετε τοIsWriteProtected, και χρησιμοποιήστε τοValidatePassword()για να ελέγξετε έναν υποψήφιο κωδικό πρόσβασης αντί να αποθηκεύετε ή να συγκρίνετε τη ακατέργαστη συμβολοσειρά μόνοι σας. CompatibilityOptions,HyphenationOptions,MailMergeSettings,ViewOptionsκαιWriteProtectionείναι όλα προσβάσιμα άμεσα από τοDocument– δεν υπάρχει ανάγκη να ψάχνετε το δέντρο κόμβων για αυτά.
Κοινά Προβλήματα
| Ζήτημα | Αιτία | Διόρθωση |
|---|---|---|
CompatibilityOptions.OptimizeFor() ρίχνει NotImplementedException | Δεν έχει υλοποιηθεί σε αυτήν την έκδοση | Ορίστε τις μεμονωμένες CompatibilityOptions λογικές ιδιότητες αντί αυτού |
| Mail merge δεν γεμίζει το έγγραφο με δεδομένα | MailMergeSettings αποθηκεύει μόνο τη διαμόρφωση συγχώνευσης· η εκτέλεση δεν περιλαμβάνεται σε αυτήν την έκδοση | Διαβάστε τη αποθηκευμένη διαμόρφωση πηγής δεδομένων και ελέγξτε τη δική σας λογική συμπλήρωσης πεδίων, ή χρησιμοποιήστε την commercial Aspose.Words για .NET |
Η αλλαγή του ViewOptions.ZoomPercent δεν έχει ορατό αποτέλεσμα κατά την επεξεργασία του εγγράφου | Το ViewOptions επηρεάζει μόνο την εμφάνιση του Word, όχι την επεξεργασία του Aspose.Words FOSS | Αναμενόμενη συμπεριφορά – δεν απαιτείται διόρθωση |
Το WriteProtection.ValidatePassword() επιστρέφει false απροσδόκητα | Το SetPassword() δεν κλήθηκε πρώτα, ή ορίστηκε διαφορετικός κωδικός | Κλήστε το SetPassword() για να ορίσετε τον προστατευμένο κωδικό πριν από την επικύρωση |
FAQ
Μπορώ να χρησιμοποιήσω το Aspose.Words FOSS για να εκτελέσω μια πραγματική συγχώνευση αλληλογραφίας;
Όχι. Το MailMergeSettings και το Odso σας επιτρέπουν να διαβάζετε και να γράφετε τη διαμόρφωση συγχώνευσης που είναι αποθηκευμένη σε ένα έγγραφο, αλλά η εκτέλεση συγχώνευσης αλληλογραφίας – η συμπλήρωση πεδίων από μια πηγή δεδομένων – δεν περιλαμβάνεται σε αυτήν την έκδοση ανοιχτού κώδικα.
Λειτουργεί το CompatibilityOptions.OptimizeFor();
Όχι – ρίχνει το NotImplementedException σε αυτή τη έκδοση. Ορίστε απευθείας τις μεμονωμένες ιδιότητες CompatibilityOptions που χρειάζεστε.
Πώς μπορώ να προστατεύσω με κωδικό πρόσβασης ένα έγγραφο από επεξεργασίες;
Καλέστε το WriteProtection.SetPassword() στο Document.WriteProtection, μετά ορίστε το IsWriteProtected για να ενεργοποιήσετε την προστασία.
Αλλάζουν τα HyphenationOptions και ViewOptions τον τρόπο διάταξης του εγγράφου;
Όχι. Και τα δύο είναι αποθηκευμένες προτιμήσεις που η Microsoft Word εφαρμόζει όταν ανοίγει και εμφανίζει το αρχείο. Αυτή η έκδοση δεν περιλαμβάνει τη μηχανή διάταξης σελίδας, έτσι αυτές οι ρυθμίσεις περνούν δια του μηχανήματος χωρίς το Aspose.Words FOSS να υπολογίζει τη διάταξη από αυτές.
API Reference Σύνοψη
| Κλάση / Enum | Περιγραφή |
|---|---|
CompatibilityOptions | Παλιές εναλλαγές διάταξης/διαστήματος έκδοσης Word, μέσω Document.CompatibilityOptions |
Compatibility | Enum που ονομάζει τις μεμονωμένες επιλογές συμβατότητας |
MsWordVersion | Τιμές έκδοσης Word που χρησιμοποιούνται από CompatibilityOptions.OptimizeFor() |
HyphenationOptions | Προτιμήσεις συλλαβισμού, μέσω Document.HyphenationOptions |
MailMergeSettings | Αποθηκευμένη διαμόρφωση συγχώνευσης αλληλογραφίας, μέσω Document.MailMergeSettings |
Odso | Ρυθμίσεις σύνδεσης Office Data Source Object για συγχώνευση αλληλογραφίας |
OdsoFieldMapData / OdsoFieldMapDataCollection | Αντιστοίχηση στήλης-πεδίου συγχώνευσης για πηγή δεδομένων ODSO |
OdsoRecipientData / OdsoRecipientDataCollection | Κατάσταση ένταξης/αποκλεισμού ανά παραλήπτη για συγχώνευση αλληλογραφίας |
ViewOptions | Προτιμήσεις εμφάνισης του Word (μεγέθυνση, σημάδια μορφοποίησης), μέσω Document.ViewOptions |
WriteProtection | Κατάσταση προστασίας εγγραφής εγγράφου, μέσω Document.WriteProtection |
MeasurementUnits | Μονάδα μέτρησης που το Word πρέπει να χρησιμοποιεί στη διεπαφή του |