Làm việc với 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 thuộc tính này có thể được chia thành hai nhóm:

  • Hệ thống hoặc phần mềm tích hợp chứa các giá trị như tiêu đề tài liệu, tên tác giả, số liệu thống kê tài liệu và các giá trị khác.
  • Do người dùng xác định hoặc tùy chỉnh, được cung cấp dưới dạng cặp tên-giá trị trong đó người dùng có thể xác định cả tên và giá trị.

Sẽ rất hữu ích khi biết rằng thông tin về API và Số phiên bản được ghi trực tiếp vào tài liệu đầu ra. Ví dụ: khi chuyển đổi tài liệu sang PDF, Aspose.Words sẽ điền vào trường “Ứng dụng” bằng “Aspose.Words” và trường “Nhà sản xuất PDF” bằng “Aspose.Words cho .NET YY.MN”, trong đó YY.M.N là phiên bản Aspose.Words được sử dụng để chuyển đổi. Để biết thêm chi tiết, xem Tên người tạo hoặc nhà sản xuất có trong tài liệu đầu ra.

Truy cập thuộc tính tài liệu

Để truy cập các thuộc tính tài liệu trong Aspose.Words, hãy sử dụng:

built_in_document_properties và custom_document_properties là tập hợp các đối tượng DocumentProperty. Những đối tượng này có thể được lấy thông qua thuộc tính bộ chỉ mục theo tên hoặc theo chỉ mục.

built_in_document_properties còn cung cấp 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 đã nhập để trả về các giá trị thuộc loại thích hợp. custom_document_properties cho phép bạn thêm hoặc xóa thuộc tính tài liệu khỏi tài liệu.

Lớp DocumentProperty cho phép bạn lấy tên, giá trị và loại thuộc tính tài liệu. value trả về một đối tượng, nhưng có một tập hợp các phương thức cho phép bạn chuyển đổi giá trị thuộc tính thành một loại cụ thể. Sau khi bạn biết loại thuộc tính là gì, bạn có thể sử dụng một trong các phương thức DocumentProperty.to_XXX, chẳng hạn như DocumentProperty.__str__ và DocumentProperty.to_int, để thu được giá trị của loại thích hợp.

Ví dụ về mã sau đây cho biết cách liệt kê tất cả các thuộc tính tùy chỉnh và tích hợp sẵn trong tài liệu:

Trong Microsoft Word, bạn có thể truy cập các thuộc tính tài liệu bằng menu “Tệp → Thuộc tính”.

làm việc với tài liệu-property-1.png

Thêm hoặc xóa thuộc tính tài liệu

Bạn không thể thêm hoặc xóa các thuộc tính tài liệu tích hợp bằng Aspose.Words. Bạn chỉ có thể thay đổi hoặc cập nhật giá trị của chúng.

Để thêm thuộc tính tài liệu tùy chỉnh bằng Aspose.Words, hãy sử dụng phương thức add, chuyển tên thuộc tính mới và giá trị của loại thích hợp. Phương thức trả về đối tượng DocumentProperty mới được tạo.

Để xóa thuộc tính tùy chỉnh, hãy sử dụng phương thức remove, chuyển cho nó tên thuộc tính cần xóa hoặc phương thức remove_at để xóa thuộc tính theo chỉ mục. Bạn cũng có thể xóa tất cả thuộc tính bằng phương thức clear.

Ví dụ về mã sau đây kiểm tra xem thuộc tính tùy chỉnh có tên cụ thể có tồn tại trong tài liệu hay không và thêm một vài thuộc tính tài liệu tùy chỉnh khác:

Ví dụ về mã sau đây cho biết cách xóa thuộc tính tài liệu tùy chỉnh:

Cập nhật thuộc tính tài liệu tích hợp

Aspose.Words không tự động cập nhật các thuộc tính tài liệu, như Microsoft Word thực hiện với một số thuộc tính, nhưng cung cấp phương pháp cập nhật một số thuộc tính tài liệu thống kê tích hợp. Gọi phương thức update_word_count để 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 được liên kết với nội dung

Aspose.Words cung cấp phương pháp add_link_to_content để tạo thuộc tính tài liệu tùy chỉnh mới được liên kết với nội dung. Thuộc tính này trả về đối tượng thuộc tính mới được tạo hoặc trả về null nếu link_source không hợp lệ.

Ví dụ về mã sau đây cho biết cách định cấu hình liên kết đến thuộc tính tùy chỉnh:

Nhận các biến tài liệu

Bạn có thể lấy tập hợp các biến tài liệu bằng thuộc tính variables. Tên và giá trị biến là chuỗi.

Ví dụ mã sau đây cho thấy cách thêm và truy cập các biến tài liệu:

Xóa thông tin cá nhân khỏi tài liệu

Nếu bạn muốn chia sẻ tài liệu Word với người khác, bạn có thể muốn xóa thông tin cá nhân như tên tác giả và công ty. Để thực hiện việc này, hãy sử dụng thuộc tính remove_personal_information để đặt cờ cho biết Microsoft Word sẽ xóa tất cả thông tin người dùng khỏi nhận xét, bản sửa đổi và thuộc tính tài liệu khi lưu tài liệu.

Ví dụ mã sau đây cho thấy cách xóa thông tin cá nhân:

Chuyển đổi giữa các đơn vị đo lường