פרטי משתמש
מידע משתמש
מדריך זה מציג כיצד להגדיר את זהות המשתמש הנוכחי ש- 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 הוא לכל מסמך — הגדר אותו על FieldOptions של Document ספציפי כדי לשלוט בשדות מידע המשתמש של מסמך זה. 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 |
