Πώς να εργαστείτε με τις ρυθμίσεις εγγράφου στο .NET
Αυτός ο οδηγός δείχνει πώς να εργαστείτε με τις ρυθμίσεις εγγράφου σε επίπεδο εφαρμογής στο Aspose.Words FOSS για .NET: εναλλαγές συμβατότητας παλαιών εκδόσεων, προτιμήσεις συλλαβισμού, η αποθηκευμένη διαμόρφωση συγχώνευσης αλληλογραφίας, επιλογές προβολής και προστασία εγγραφής. Το Aspose.Words FOSS για .NET είναι διαθέσιμο μέσω NuGet ή με κατασκευή από τον πηγαίο κώδικα.
Οδηγός βήμα-βήμα
Βήμα 1: Λάβετε τη βιβλιοθήκη
Κλωνοποιήστε το αποθετήριο και κάντε build Aspose.Words.sln σε διαμόρφωση Release, στη συνέχεια προσθέστε μια αναφορά έργου στο Aspose.Words.csproj από το δικό σας έργο .NET, όπως περιγράφεται στο Οδηγός εγκατάστασης. Προσθέστε using Aspose.Words; and using Aspose.Words.Settings; στην αρχή οποιουδήποτε αρχείου που διαβάζει ή γράφει ρυθμίσεις εγγράφου.
Βήμα 2: Ορίστε τις επιλογές συμβατότητας παλαιών εκδόσεων
Document.CompatibilityOptions (ένα στιγμιότυπο CompatibilityOptions) περιέχει δεκάδες λογικές εναλλαγές που αναπαράγουν συγκεκριμένες συμπεριφορές διάταξης και απόστασης παλαιότερων εκδόσεων του Word — για παράδειγμα GrowAutofit, UseWord2010TableStyleRules, AdjustLineHeightInTable, AlignTablesRowByRow, NoExtraLineSpacing, SuppressSpacingAtTopOfPage και SpacingInWholePoints. Ορίστε άμεσα τις μεμονωμένες ιδιότητες που χρειάζεστε· το OptimizeFor(MsWordVersion) υπάρχει στην κλάση αλλά προκαλεί NotImplementedException σε αυτήν την έκδοση, επομένως δεν υπάρχει συντόμευση που να εφαρμόζει ολόκληρο προφίλ έκδοσης ταυτόχρονα.
Βήμα 3: Διαμόρφωση προτιμήσεων συλλαβισμού
Document.HyphenationOptions (μια HyphenationOptions παρουσία) αποθηκεύει τις προτιμήσεις συλλαβισμού του Word για το έγγραφο: AutoHyphenation, ConsecutiveHyphenLimit, HyphenateCaps και HyphenationZone. Αυτές οι ιδιότητες μεταφέρουν το αίτημα στο αποθηκευμένο αρχείο· επειδή αυτή η έκδοση δεν διαθέτει μηχανή διάταξης σελίδων, οι διακοπές συλλαβισμού υπολογίζονται από το Word όταν ανοίγει και σελιδοποιεί το αρχείο, όχι από το Aspose.Words FOSS.
Βήμα 4: Ανάγνωση και εγγραφή ρυθμίσεων συγχώνευσης αλληλογραφίας
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 και RecipientDatas περιγράφουν την αντιστοίχηση πεδίων και τη λίστα παραληπτών. Η ανάγνωση και η εγγραφή αυτής της αποθηκευμένης ρύθμισης είναι διαθέσιμη σε αυτήν την έκδοση ανοιχτού κώδικα· η εκτέλεση της ίδιας της συγχώνευσης έναντι μιας ζωντανής πηγής δεδομένων είναι ξεχωριστό ζήτημα εκτός του πεδίου αυτής της σελίδας.
Βήμα 5: Διαμόρφωση ρυθμίσεων προβολής εγγράφου
Document.ViewOptions (μια ViewOptions παρουσία) ελέγχει τον τρόπο με τον οποίο το Word εμφανίζει το αρχείο μόλις ανοιχτεί: ViewType, ZoomType, ZoomPercent, DisplayBackgroundShape, DoNotDisplayPageBoundaries και FormsDesign. Αυτές οι ιδιότητες είναι αποθηκευμένες προτιμήσεις που επηρεάζουν μόνο την προβολή του εγγράφου από το Word — δεν έχουν καμία επίδραση στο πώς το Aspose.Words FOSS επεξεργάζεται το αρχείο.
Βήμα 6: Εφαρμογή προστασίας εγγραφής
Document.WriteProtection (μια WriteProtection παρουσία) εκθέτει τα IsWriteProtected και ReadOnlyRecommended, με το SetPassword() για τον καθορισμό κωδικού προστασίας και το ValidatePassword() για τη δοκιμή ενός υποψήφιου κωδικού απέναντι σε αυτόν. Κλήστε το SetPassword() πριν ορίσετε το IsWriteProtected = true, και χρησιμοποιήστε το ValidatePassword() αντί να αποθηκεύετε ή να συγκρίνετε εσείς τη μη επεξεργασμένη συμβολοσειρά κωδικού.
Κοινά προβλήματα και διορθώσεις
CompatibilityOptions.OptimizeFor() throws NotImplementedException. Αυτή η μέθοδος δεν έχει υλοποιηθεί σε αυτήν την build. Ορίστε τις ατομικές CompatibilityOptions ιδιότητες boolean που χρειάζεστε απευθείας αντί αυτού.
Changing ViewOptions.ZoomPercent δεν έχει ορατό αποτέλεσμα στην παραγόμενη έξοδο. ViewOptions είναι μια αποθηκευμένη προτίμηση εμφάνισης που διαβάζει το Word, όχι κάτι που το Aspose.Words FOSS εφαρμόζει κατά την επεξεργασία. Δεν απαιτείται διόρθωση — αυτό είναι αναμενόμενο.
WriteProtection.ValidatePassword() επιστρέφει απροσδόκητα false. SetPassword() δεν κλήθηκε ποτέ, ή ορίστηκε διαφορετικός κωδικός πρόσβασης. Καλέστε SetPassword() πρώτα για να ορίσετε τον προστατευμένο κωδικό πριν από την επικύρωση.
Η διαμόρφωση συγχώνευσης αλληλογραφίας αποθηκεύεται, αλλά η συγχώνευση δεν εκτελείται. MailMergeSettings and Odso αποθηκεύει μόνο τη διαμόρφωση συγχώνευσης· αυτή η έκδοση ανοιχτού κώδικα δεν εκτελεί τη συγχώνευση από μόνη της. Διαβάστε τη αποθηκευμένη διαμόρφωση και υλοποιήστε τη δική σας λογική πληρωμής πεδίων με βάση αυτήν.
Συχνές ερωτήσεις
Το CompatibilityOptions.OptimizeFor() λειτουργεί;
Όχι — προκαλεί NotImplementedException σε αυτήν την έκδοση. Ορίστε απευθείας τις μεμονωμένες ιδιότητες CompatibilityOptions που χρειάζεστε.
Πώς μπορώ να προστατέψω με κωδικό πρόσβασης ένα έγγραφο από επεμβάσεις;
Καλείτε το WriteProtection.SetPassword() στο Document.WriteProtection, έπειτα ορίστε το IsWriteProtected για να ενεργοποιήσετε την προστασία.
Αλλάζουν τα HyphenationOptions και ViewOptions την εμφάνιση του εγγράφου όταν το επεξεργάζεται το Aspose.Words FOSS;
Όχι. Και τα δύο είναι αποθηκευμένες προτιμήσεις που εφαρμόζει το Word όταν ανοίγει και εμφανίζει το αρχείο· αυτή η έκδοση δεν διαθέτει μηχανή διάταξης σελίδας για να τις επεξεργαστεί άμεσα.
Πού μπορώ να βρω τη ρύθμιση προέλευσης δεδομένων συγχώνευσης αλληλογραφίας για μια εξωτερική πηγή δεδομένων;
MailMergeSettings.Odso — οι συλλογές FieldMapDatas και RecipientDatas περιγράφουν την αντιστοίχιση στηλών και την κατάσταση ένταξης παραληπτών.
Ποια είναι η διαφορά μεταξύ Document.CompatibilityOptions και Document.ViewOptions;
CompatibilityOptions διακόπτες αναπαράγουν τις παλαιότερες ιδιαιτερότητες διάταξης και απόστασης του Word· ViewOptions ελέγχει πώς η δική του διεπαφή του Word εμφανίζει το αρχείο (ζουμ, σημάδια μορφοποίησης). Καμία από τις δύο δεν υπολογίζεται από το ίδιο το Aspose.Words FOSS.