Thông tin người dùng

Thông tin người dùng

Hướng dẫn này cho thấy cách thiết lập danh tính người dùng hiện tại mà Aspose.Words FOSS cho .NET báo cáo thông qua các trường tài liệu liên quan đến người dùng.

UserInformation đại diện cho danh tính Aspose.Words FOSS mà .NET sử dụng khi đánh giá các trường báo cáo “người dùng hiện tại” — Name, Initials và Address. Nó được gắn vào cài đặt đánh giá trường của tài liệu thông qua FieldOptions.CurrentUser, và một phương án dự phòng toàn bộ quá trình có sẵn thông qua UserInformation.DefaultUser.

Cài đặt Người dùng Hiện tại

Document.FieldOptions (một thể hiện FieldOptions) cung cấp CurrentUser, một đối tượng UserInformation. Đặt các thuộc tính Name, Initials và Address của nó trước khi cập nhật các trường thông tin người dùng để các giá trị chúng báo cáo phù hợp với danh tính mà ứng dụng của bạn muốn ghi lại. UserInformation.DefaultUser cung cấp một thể hiện UserInformation tĩnh, toàn bộ quá trình để dự phòng khi FieldOptions.CurrentUser của tài liệu chưa được đặt một cách rõ ràng.

Các trường Thông tin Người dùng

Ba lớp con Field đọc danh tính người dùng hiện tại vào phần thân tài liệu: FieldUserName (trường USERNAME, với thuộc tính UserName), FieldUserAddress (trường USERADDRESS, với thuộc tính UserAddress), và FieldUserInitials (trường USERINITIALS, với thuộc tính UserInitials). Giống như các trường khác, chúng chia sẻ vòng đời cơ bản Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — và có thể được chèn bằng DocumentBuilder.InsertField(fieldCode) hoặc InsertField(fieldType, updateField) sử dụng FieldType.FieldUserName, FieldType.FieldUserAddress, hoặc FieldType.FieldUserInitials.

Mẹo và Thực hành Tốt nhất

• Đặt FieldOptions.CurrentUser trước khi gọi Update() trên trường FieldUserName, FieldUserAddress hoặc FieldUserInitials, hoặc trước Document.UpdateFields() — nếu không, các trường sẽ được giải quyết dựa trên UserInformation hiện đang có hiệu lực.
• UserInformation.DefaultUser là một mặc định chung tiện lợi khi cùng một danh tính áp dụng cho mọi tài liệu mà ứng dụng của bạn xử lý; đặt FieldOptions.CurrentUser theo từng tài liệu khi các tài liệu khác nhau cần các tác giả khác nhau.
• Điền đầy cả ba Name, Initials và Address cùng nhau nếu mẫu của bạn sử dụng nhiều hơn một trong số FieldUserName, FieldUserAddress và FieldUserInitials — để một trường trống sẽ tạo ra kết quả trường rỗng thay vì lỗi.

Các vấn đề thường gặp

FAQ

Sự khác biệt giữa FieldOptions.CurrentUser và UserInformation.DefaultUser là gì?

FieldOptions.CurrentUser là theo từng tài liệu — đặt nó trên FieldOptions của một Document cụ thể để kiểm soát các trường thông tin người dùng của tài liệu đó. UserInformation.DefaultUser là một dự phòng tĩnh, áp dụng cho toàn bộ quá trình.

Các trường nào UserInformation ảnh hưởng?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS), và FieldUserInitials (USERINITIALS) — mỗi cái đọc thuộc tính Name, Address, hoặc Initials tương ứng từ UserInformation đang hoạt động.

Tôi có cần gọi Update() sau khi thay đổi UserInformation không?

Có — việc thay đổi Name, Initials hoặc Address sẽ không cập nhật ngược lại các trường đã được tính toán trong tài liệu; hãy gọi Update() trên trường cụ thể hoặc Document.UpdateFields().

API Reference Tóm tắt

Xem thêm

• Aspose.Words for .NET — Enterprise Documentation