Chỉnh sửa thuộc tính tài liệu
Thuộc tính tài liệu cho phép lưu trữ một số thông tin hữu ích về tài liệu của bạn. Những tính chất này có thể chia thành hai nhóm:
- Hệ thống hoặc nội bộ chứa giá trị như tiêu đề tài liệu, tên tác giả, thống kê tài liệu và những người khác.
- Người dùng hoặc tùy chỉnh, được cung cấp dưới dạng cặp tên giá trị nơi người dùng có thể xác định cả tên và giá trị.
Điều hữu ích biết rằng thông tin về API và số phiên bản là được viết trực tiếp vào các tài liệu đầu ra. Ví dụ, khi chuyển đổi một tài liệu sang PDF thì Aspose.Words sẽ điền vào trường “Application” với “Aspose.Words”, và trường “PDF Producer” với “Aspose.Words for Java YY.M.N”, trong đó YY.M.N là phiên bản của Aspose.Words được dùng cho việc chuyển đổi. Để biết thêm chi tiết, xem Generator or Producer Name Included in Output Documents.
Truy cập các thuộc tính của tài liệu
Để truy cập thuộc tính tài liệu trong Aspose.Words sử dụng:
.* BuiltInDocumentProperties để có các thuộc tính được xây dựng sẵn.
- CustomDocumentProperties để lấy các thuộc tính tùy chỉnh.
BuiltInDocumentProperties và CustomDocumentProperties là tập hợp của DocumentProperty đối tượng. Những đối tượng này có thể được truy cập thông qua thuộc tính indexer bằng cách dùng tên hoặc chỉ số.
BuiltInDocumentProperties cung cấp thêm quyền truy cập vào các thuộc tính tài liệu thông qua một tập hợp các thuộc tính được nhập mà trả về các giá trị của loại phù hợp. CustomDocumentProperties cho phép bạn thêm hoặc xóa các thuộc tính tài liệu từ một tài liệu.
Lớp DocumentProperty cho phép bạn nhận được tên, giá trị và kiểu của một thuộc tính tài liệu. [Value]https://reference.aspose.com/words/java/com.aspose.words/documentproperty#Value) returns an object, but there is a set of methods allowing you to get the property value converted to a specific type. After you get to know what type the property is, you can use one of the {0} methods, such as {1}ToString và DocumentProperty.ToInt, để có được giá trị của loại thích hợp.
Mã ví dụ sau cho thấy cách liệt kê tất cả các thuộc tính tích hợp và tùy chỉnh trong một tài liệu:
Trong Microsoft Word có thể truy cập thuộc tính tài liệu bằng cách sử dụng trình đơn “Tệp → Thuộc tính.
Thêm hoặc Loại bỏ Thuộc tính Tài liệu
Bạn không thể thêm hay xóa các thuộc tính tài liệu được xây dựng sẵn bằng cách sử dụng Aspose.Words. Bạn chỉ có thể thay đổi hoặc cập nhật giá trị của họ.
Để thêm thuộc tính tài liệu tùy chỉnh với Aspose.Words, sử dụng phương thức Add truyền tên thuộc tính mới và giá trị loại thích hợp. Phương pháp trả về đối tượng mới được tạo DocumentProperty.
Để loại bỏ các thuộc tính tùy chỉnh, hãy sử dụng Remove phương pháp, truyền tên thuộc tính để loại bỏ, hoặc RemoveAt phương pháp để loại bỏ thuộc tính bằng chỉ số. Bạn cũng có thể loại bỏ tất cả các thuộc tính bằng cách sử dụng Clear phương pháp.
Mã ví dụ sau kiểm tra xem một thuộc tính tùy chỉnh với tên đã cho có tồn tại trong tài liệu và thêm vài thuộc tính tài liệu tùy chỉnh khác:
Ví dụ mã sau cho thấy cách loại bỏ một thuộc tính tài liệu tùy chỉnh:
Cập nhật các thuộc tính tài liệu được xây dựng sẵn
Aspose.Words không tự động cập nhật các thuộc tính tài liệu như Microsoft Word đã làm với một số thuộc tính nhất định, nhưng cung cấp một phương pháp để cập nhật một số thuộc tính tích hợp về tài liệu. Gọi phương thức UpdateWordCount để tính toán lại và cập nhật các thuộc tính sau:
Tạo một thuộc tính tùy chỉnh mới liên kết với Nội dung
Aspose.Words cung cấp phương pháp AddLinkToContent để tạo một thuộc tính tài liệu tùy chỉnh liên kết với nội dung. Tính năng này trả về đối tượng thuộc tính đã được tạo mới hoặc null nếu LinkSource không hợp lệ.
Ví dụ mã sau cho thấy cách thiết lập liên kết đến thuộc tính tùy chỉnh:
Lấy biến tài liệu
Bạn có thể nhận được một tập hợp các biến tài liệu bằng cách sử dụng thuộc tính Variables. Tên biến và giá trị là chuỗi.
Ví dụ sau cho thấy cách liệt kê các biến tài liệu như thế nào:
Loại bỏ Thông tin Cá nhân từ Tài liệu
Nếu bạn muốn chia sẻ một tài liệu word với người khác, bạn có thể muốn loại bỏ thông tin cá nhân như tên tác giả và công ty. Để làm điều này hãy dùng thuộc tính RemovePersonalInformation để đặt cờ cho biết rằng Microsoft Word sẽ loại bỏ tất cả thông tin người dùng từ các bình luận, sửa đổi và tài sản tài liệu khi lưu tài liệu.