Πληροφορίες Χρήστη
Πληροφορίες Χρήστη
Αυτός ο οδηγός δείχνει πώς να ορίσετε την ταυτότητα του τρέχοντος χρήστη που Aspose.Words FOSS για .NET αναφέρει μέσω πεδίων εγγράφου σχετικών με τον χρήστη.
UserInformation αντιπροσωπεύει την ταυτότητα Aspose.Words FOSS που χρησιμοποιεί το .NET κατά την αξιολόγηση πεδίων που αναφέρουν «τον τρέχοντα χρήστη» — Name, Initials και Address. Συνδέεται με τις ρυθμίσεις αξιολόγησης πεδίων ενός εγγράφου μέσω FieldOptions.CurrentUser, και υπάρχει εφεδρική επιλογή σε όλη τη διαδικασία μέσω UserInformation.DefaultUser.
Ορισμός του Τρέχοντος Χρήστη
Document.FieldOptions (μία περίπτωση FieldOptions) εκθέτει το CurrentUser, ένα αντικείμενο UserInformation. Ορίστε τις ιδιότητες Name, Initials και Address του πριν ενημερώσετε τα πεδία πληροφοριών χρήστη, ώστε οι τιμές που αναφέρουν να ταιριάζουν με την ταυτότητα που θέλει η εφαρμογή σας να καταγραφεί. Το UserInformation.DefaultUser παρέχει μια στατική, διαδικαστική UserInformation περίπτωση για να χρησιμοποιηθεί ως εφεδρεία όταν το FieldOptions.CurrentUser ενός εγγράφου δεν έχει οριστεί ρητά.
Πεδία Πληροφοριών Χρήστη
Τρία υποκλάσεις του Field διαβάζουν την ταυτότητα του τρέχοντος χρήστη στο σώμα του εγγράφου: FieldUserName (το πεδίο USERNAME, με ιδιότητα UserName), FieldUserAddress (το πεδίο USERADDRESS, με ιδιότητα UserAddress), και FieldUserInitials (το πεδίο USERINITIALS, με ιδιότητα UserInitials). Όπως και άλλα πεδία, μοιράζονται τον βασικό κύκλο ζωής του Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — και μπορούν να εισαχθούν με DocumentBuilder.InsertField(fieldCode) ή InsertField(fieldType, updateField) χρησιμοποιώντας FieldType.FieldUserName, FieldType.FieldUserAddress ή FieldType.FieldUserInitials.
Συμβουλές και Βέλτιστες Πρακτικές
- Ορίστε το
FieldOptions.CurrentUserπριν καλέσετε τοUpdate()σε ένα πεδίοFieldUserName,FieldUserAddressήFieldUserInitials, ή πριν τοDocument.UpdateFields()— διαφορετικά τα πεδία θα λυθούν σε σχέση με ό,τιUserInformationείναι αυτή τη στιγμή σε ισχύ. - Το
UserInformation.DefaultUserείναι ένα βολικό κοινό προεπιλεγμένο όταν η ίδια ταυτότητα ισχύει για κάθε έγγραφο που επεξεργάζεται η εφαρμογή σας· ορίστε τοFieldOptions.CurrentUserανά έγγραφο όταν διαφορετικά έγγραφα χρειάζονται διαφορετικούς συγγραφείς. - Συμπληρώστε και τα τρία
Name,InitialsκαιAddressμαζί εάν τα πρότυπά σας χρησιμοποιούν περισσότερα από ένα τωνFieldUserName,FieldUserAddressκαιFieldUserInitials— η άδεια αφήνουμε ένα από αυτά παράγει κενό αποτέλεσμα πεδίου αντί για σφάλμα.
Κοινά Προβλήματα
| Πρόβλημα | Αιτία | Διόρθωση |
|---|---|---|
FieldUserName αποτέλεσμα είναι κενό μετά το Update() | UserInformation.Name δεν ορίστηκε ποτέ στο ενεργό UserInformation | Ορίστε FieldOptions.CurrentUser.Name (ή UserInformation.DefaultUser.Name) πριν ενημερώσετε το πεδίο |
| Τα πεδία πληροφοριών χρήστη εμφανίζουν τον λάθος συγγραφέα σε όλα τα έγγραφα | UserInformation.DefaultUser είναι κοινόχρηστο σε όλη τη διαδικασία | Ορίστε το Document.FieldOptions.CurrentUser ανά έγγραφο αντί να βασίζεστε στην προεπιλογή |
FAQ
Ποια είναι η διαφορά μεταξύ FieldOptions.CurrentUser και UserInformation.DefaultUser;
Το FieldOptions.CurrentUser είναι ανά έγγραφο — ορίστε το σε ένα συγκεκριμένο Document’s FieldOptions για να ελέγξετε τα πεδία πληροφοριών χρήστη του εγγράφου. Το UserInformation.DefaultUser είναι μια στατική, καθολική εναλλακτική λύση.
Ποια πεδία επηρεάζει το UserInformation;
FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) και FieldUserInitials (USERINITIALS) — καθένα διαβάζει την αντίστοιχη ιδιότητα Name, Address ή Initials από το ενεργό UserInformation.
Χρειάζεται να καλέσω το Update() μετά την αλλαγή του UserInformation;
Ναι — η αλλαγή των Name, Initials ή Address δεν ενημερώνει παλαιότερα τα πεδία που έχουν ήδη αξιολογηθεί στο έγγραφο· καλέστε το Update() στο συγκεκριμένο πεδίο ή το Document.UpdateFields().
API Reference Περίληψη
| Κλάση / Ιδιότητα | Περιγραφή |
|---|---|
UserInformation | Name, Initials, Address; στατική εφεδρική παρουσία DefaultUser |
FieldOptions.CurrentUser | Το UserInformation ανά έγγραφο χρησιμοποιείται κατά την αξιολόγηση πεδίων πληροφοριών χρήστη |
FieldUserName / FieldUserAddress / FieldUserInitials | Πεδία USERNAME, USERADDRESS, USERINITIALS |