معلومات المستخدم
معلومات المستخدم
يوضح هذا الدليل كيفية تعيين هوية المستخدم الحالي التي 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 |
