ข้อมูลผู้ใช้
ข้อมูลผู้ใช้
คู่มือนี้แสดงวิธีตั้งค่าตัวตนของผู้ใช้ปัจจุบันที่ 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 อินสแตนซ์สำรองแบบ static |
FieldOptions.CurrentUser | ค่า UserInformation ต่อเอกสารที่ใช้เมื่อประเมินฟิลด์ข้อมูลผู้ใช้ |
FieldUserName / FieldUserAddress / FieldUserInitials | ฟิลด์ USERNAME, USERADDRESS, USERINITIALS |
