اطلاعات کاربر
اطلاعات کاربر
این راهنما نشان می‌دهد چگونه هویت کاربر فعلی را تنظیم کنید که 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 وارد شوند.
نکات و بهترین روش‌ها
- قبل از فراخوانی
Update()روی فیلدFieldUserName،FieldUserAddressیاFieldUserInitials،FieldOptions.CurrentUserرا تنظیم کنید، یا قبل ازDocument.UpdateFields()— در غیر این صورت فیلدها نسبت به هرUserInformationکه در حال حاضر مؤثر است، حل می‌شوند. UserInformation.DefaultUserیک پیش‌فرض مشترک و مناسب است وقتی که همان هویت برای تمام اسنادی که برنامه شما پردازش می‌کند، اعمال می‌شود؛ برای هر سندFieldOptions.CurrentUserرا تنظیم کنید وقتی اسناد مختلف نیاز به نویسندگان متفاوت دارند.- اگر قالب‌های شما بیش از یکی از
FieldUserName،FieldUserAddressوFieldUserInitialsرا استفاده می‌کنند، هر سهName،InitialsوAddressرا به‌صورت همزمان پر کنید — خالی گذاشتن یکی منجر به نتیجهٔ فیلد خالی می‌شود نه خطا.
مشکلات رایج
| مسئله | دلیل | رفع |
|---|---|---|
نتیجهٔ 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 فعال می‌خوانند.
آیا پس از تغییر UserInformation باید Update() را فراخوانی کنم؟
بله — تغییر Name، Initials یا Address به‌صورت بازگشت‌دار فیلدهای قبلاً ارزیابی‌شده در سند را به‌روز نمی‌کند؛ باید Update() را بر روی فیلد خاص یا Document.UpdateFields() فراخوانی کنید.
خلاصه API Reference
| کلاس / ویژگی | توضیح |
|---|---|
UserInformation | Name, Initials, Address; DefaultUser نمونهٔ استاتیک بازگشتی |
FieldOptions.CurrentUser | مقدار UserInformation برای هر سند که هنگام ارزیابی فیلدهای اطلاعات کاربر استفاده می‌شود |
FieldUserName / FieldUserAddress / FieldUserInitials | فیلدهای USERNAME، USERADDRESS، USERINITIALS |
