Μορφοποίηση Αποτελεσμάτων Πεδίου

Μορφοποίηση Αποτελέσματος Πεδίου

Αυτός ο οδηγός δείχνει πώς να ελέγχετε τη μορφοποίηση αριθμητικών, ημερομηνίας/ώρας και γενική μορφοποίηση που εφαρμόζεται στο υπολογιζόμενο αποτέλεσμα ενός πεδίου στο Aspose.Words FOSS για .NET, χρησιμοποιώντας την κλάση FieldFormat, το enum GeneralFormat και το GeneralFormatCollection. Κάθε αντικείμενο Field εκθέτει αυτές τις επιλογές μορφοποίησης μέσω της ιδιότητας Format· αυτή η σελίδα είναι η εις βάθος ανάλυση του τι προσφέρει αυτή η ιδιότητα.

Πρόσβαση στη Μορφοποίηση ενός Πεδίου

Κάθε Field — και οι τυποποιημένες υποκλάσεις του, όπως FieldDate, FieldCreateDate και FieldSymbol — εκθέτει μια ιδιότητα Format τύπου FieldFormat, που χρησιμοποιείται για τυποποιημένη πρόσβαση στη μορφοποίηση αριθμητικών, ημερομηνίας/ώρας και γενική μορφοποίηση του πεδίου. Διαβάστε το Field.Format για να εξετάσετε ή να αλλάξετε τις εναλλαγές που είναι συνδεδεμένες με τον κώδικα του πεδίου χωρίς να επεξεργαστείτε χειροκίνητα το ακατέργαστο κείμενο κώδικα του πεδίου.

Εικόνες Μορφοποίησης Αριθμητικών και Ημερομηνίας/Ώρας

FieldFormat.NumericFormat είναι μια εγγράψιμη ιδιότητα string που κρατά τη μορφοποίηση που εφαρμόζεται στο αποτέλεσμα ενός αριθμητικού πεδίου. FieldFormat.DateTimeFormat είναι μια εγγράψιμη ιδιότητα string που κρατά τη μορφοποίηση που εφαρμόζεται στο αποτέλεσμα ενός πεδίου ημερομηνίας και ώρας. Ορίστε οποιαδήποτε από τις ιδιότητες για να αλλάξετε τον τρόπο με τον οποίο ο αντίστοιχος τύπος πεδίου εμφανίζει την υπολογισμένη του τιμή.

Γενικές Μορφές

FieldFormat.GeneralFormats επιστρέφει ένα GeneralFormatCollection — γενικού σκοπού μορφές που εφαρμόζονται σε αριθμητικό, κειμενικό ή οποιοδήποτε αποτέλεσμα πεδίου. Τα μέλη του προέρχονται από την απαρίθμηση GeneralFormat, η οποία καλύπτει μετατροπές κεφαλαίων (Upper, Lower, FirstCap, Caps), ρωμαϊκή και διαδοχική αρίθμηση (UppercaseRoman, LowercaseRoman, Ordinal, OrdText), νομίσματα και κειμενικούς αριθμούς (DollarText, BahtText, CardText), συστήματα αρίθμησης ειδικά για τοπικές ρυθμίσεις (Aiueo, Arabic, ArabicAbjad, ArabicAlpha, ArabicDash, ChineseNum1–ChineseNum3, KanjiNum1–KanjiNum3, Hebrew1, Hebrew2, Ganada, Chosung, Zodiac1–Zodiac3, ThaiArabic, ThaiCardText, ThaiLetter, HindiArabic, HindiCardText, HindiLetter1, HindiLetter2, VietCardText, DBNum1–DBNum4, DBChar, SBChar, GB1–GB4, Hex, CircleNum, UppercaseAlphabetic, LowercaseAlphabetic), και τις τιμές ειδικές για πεδία συγχώνευσης CharFormat, MergeFormat και MergeFormatInet. None αφαιρεί τη γενική μορφοποίηση.

Διαχείριση του GeneralFormatCollection

GeneralFormatCollection υλοποιεί το IEnumerable<GeneralFormat>, ώστε να μπορείτε να το επαναλάβετε με το GetEnumerator() σε έναν βρόχο foreach. Καλέστε το Add(item) για να προσθέσετε μια τιμή GeneralFormat, το Remove(item) για να αφαιρέσετε κάθε εμφάνιση μιας τιμής, ή το RemoveAt(index) για να αφαιρέσετε την τιμή σε συγκεκριμένη θέση. Το Count αναφέρει πόσες γενικές μορφές εφαρμόζονται αυτή τη στιγμή.

Συμβουλές και Καλές Πρακτικές

• Ορίστε το Field.Format.NumericFormat ή το Field.Format.DateTimeFormat αντί να ενσωματώνετε μια εικόνα μορφοποίησης απευθείας στη συμβολοσειρά του κώδικα πεδίου — η τυποποιημένη ιδιότητα διατηρεί τον κώδικα πεδίου και το διακόπτη μορφοποίησής του σε συγχρονισμό.
• Συνδυάστε πολλαπλές τιμές GeneralFormat (για παράδειγμα Upper και MergeFormat) προσθέτοντας καθεμία στο GeneralFormats ξεχωριστά· η συλλογή επιτρέπει περισσότερες από μία καταχωρίσεις.
• Μετά την αλλαγή οποιασδήποτε ιδιότητας FieldFormat, καλέστε το Update() στο πεδίο ιδιοκτήτη ώστε η νέα μορφοποίηση να αντικατοπτρίζεται στο Result / DisplayResult.
• Χρησιμοποιήστε το GeneralFormat.None για να διαγράψετε ρητά μια καταχώρηση γενικής μορφής αντί να αφήνετε παλιές τιμές μορφοποίησης στη συλλογή.
• Ελέγξτε GeneralFormatCollection.Count πριν υποθέσετε ότι ένα πεδίο δεν έχει εφαρμοσμένη γενική μορφοποίηση — μια κενή συλλογή και μια συλλογή που περιέχει None είναι διαφορετικές καταστάσεις.

Συνηθισμένα προβλήματα

FAQ

Για ποιο σκοπό χρησιμοποιείται το FieldFormat;

Αυτή είναι η τυποποιημένη αντικειμενική μορφοποίηση που εκτίθεται από το Field.Format, παρέχοντας πρόσβαση στη αριθμητική μορφή ενός πεδίου (NumericFormat), στη μορφή ημερομηνίας/ώρας (DateTimeFormat) και στις γενικές μορφές (GeneralFormats).

Μπορεί ένα πεδίο να έχει εφαρμόσει περισσότερες από μία γενικές μορφές;

Ναι — το GeneralFormats είναι ένα GeneralFormatCollection, και μπορείτε να Add περισσότερες από μία τιμές GeneralFormat σε αυτό.

Πώς μπορώ να αφαιρέσω όλες τις γενικές μορφές από ένα πεδίο;

Επανάλαβε το GeneralFormats και κάλεσε το Remove(item) για κάθε τιμή, ή το RemoveAt(index) για μια συγκεκριμένη καταχώρηση.

Η ρύθμιση των ιδιοτήτων FieldFormat ανανεώνει αυτόματα το εμφανιζόμενο κείμενο του πεδίου;

Όχι — κάλεσε το Update() στο πεδίο μετά την αλλαγή των ιδιοτήτων Format ώστε τα Result και DisplayResult να αντικατοπτρίζουν τη νέα μορφοποίηση.

API Reference Περίληψη

Δείτε επίσης

• Aspose.Words for .NET — Enterprise Documentation