Thay thế Trường với Văn bản tĩnh

Thay thế các trường thường được yêu cầu khi bạn muốn lưu tài liệu của bạn dưới dạng bản sao tĩnh. Ví dụ, khi gửi đính kèm trong một email. Chuyển đổi các trường như DATE hoặc TIME thành văn bản tĩnh sẽ cho phép tài liệu hiển thị cùng ngày khi nó được gửi. Cũng vậy, trong một số tình huống, bạn có thể cần phải loại bỏ các trường điều kiện IF từ tài liệu của bạn và thay thế chúng bằng kết quả văn bản mới nhất. Ví dụ như chuyển đổi kết quả của trường IF thành văn bản tĩnh để không còn thay đổi giá trị tự động khi các trường trong tài liệu được cập nhật.

Biểu đồ dưới đây cho thấy cách lưu trữ IF trong tài liệu như thế nào:

• văn bản bị bao quanh bởi các nút trường đặc biệt – FieldStart và FieldEnd
• nút FieldSeparator tách văn bản trong trường thành mã trường và kết quả trường “* mã trường xác định hành vi chung của trường, trong khi kết quả trường duy trì kết quả mới nhất khi trường được cập nhật bằng cách sử dụng Microsoft Word hoặc Aspose.Words”
• trường kết quả là những gì được lưu trữ trong trường và hiển thị trong tài liệu khi xem

Cấu trúc cũng có thể được thấy dưới dạng phân cấp sử dụng dự án demo “DocumentExplorer”, đi kèm với trình cài đặt Aspose.Words.

Những lĩnh vực không thể thay thế bằng văn bản

Thay thế một trường với văn bản tĩnh không hoạt động đúng đối với một số trường trong tiêu đề hoặc chân trang.

Ví dụ, việc cố gắng chuyển đổi trường PAGE trong tiêu đề hoặc chân trang thành văn bản tĩnh sẽ dẫn đến cùng một giá trị hiển thị trên tất cả các trang. Đây là vì tiêu đề và chân trang được lặp lại trên nhiều trang, và khi chúng vẫn còn là các trường, chúng được xử lý đặc biệt để hiển thị kết quả chính xác cho mỗi trang.

Tuy nhiên, trong phần tiêu đề, PAGE dịch khá dễ thành đoạn văn tĩnh. Phần văn bản này sẽ được đánh giá như thể nó là trang cuối cùng trong phần, điều này sẽ khiến bất kỳ trường nào PAGE ở tiêu đề hiển thị trang cuối cùng trên tất cả các trang.

Mã ví dụ sau cho thấy cách thay thế trường bằng kết quả mới nhất của nó:

Chuyển đổi Loại Trường nhất định ở các Phần Tài liệu cụ thể

Từ ConvertFieldsToStaticText phương pháp chấp nhận hai tham số - các thuộc tính CompositeNode và FieldType enum, nó là có thể để truyền bất kỳ nút tổng hợp nào đến phương pháp này. Điều này cho phép các trường được chuyển đổi thành văn bản tĩnh chỉ trong các phần cụ thể của tài liệu.

Ví dụ, bạn có thể truyền một Document đối tượng và chuyển đổi các lĩnh vực của loại được chỉ định từ toàn bộ tài liệu thành văn bản tĩnh, hoặc bạn có thể truyền một Body đối tượng của một phần và chuyển đổi chỉ các lĩnh vực tìm thấy trong cơ thể đó.

Khi đi qua một nút block-level như Paragraph, hãy biết rằng trong một số trường hợp, các trường có thể trải rộng trên nhiều đoạn văn. Nếu điều này xảy ra, được khuyến nghị để truyền cha của hợp thành thay vì để tránh điều này.

Việc liệt kê FieldType được truyền vào phương thức ConvertFieldsToStaticText xác định loại trường nào nên chuyển đổi thành văn bản tĩnh. Bất kỳ loại trường nào khác được tìm thấy trong tài liệu sẽ vẫn không thay đổi.

Mã ví dụ sau cho thấy cách chọn các trường của một loại cụ thể - targetFieldType trên một nút cụ thể - compositeNode và sau đó chuyển đổi chúng thành văn bản tĩnh:

Mã ví dụ sau cho thấy cách chuyển đổi tất cả các trường IF trong tài liệu sang văn bản tĩnh:

Mã ví dụ sau cho thấy cách chuyển đổi tất cả các PAGE trường trong cơ thể của một tài liệu thành văn bản tĩnh:

Mã ví dụ sau đây cho thấy cách chuyển đổi tất cả các IF trường trong đoạn cuối cùng thành văn bản tĩnh: