Cách làm việc với các trường chuyển tiếp trong .NET

Bước 1: Tìm các trường chuyển tiếp trong tài liệu

Liệt kê Document.Range.Fields và so sánh Type của mỗi trường (một giá trị FieldType) với các hằng số liên quan — FieldBarcode, FieldDisplayBarcode, FieldMergeBarcode, FieldBidiOutline, FieldEQ, FieldFootnoteRef hoặc FieldInfo — sau đó cast đối tượng Field chung sang lớp phù hợp để truy cập các thuộc tính cụ thể của nó. Luôn kiểm tra Type trước khi cast: việc cast sang lớp trường sai sẽ gây ra một InvalidCastException.

Bước 2: Cấu hình trường DISPLAYBARCODE hoặc MERGEBARCODE

FieldDisplayBarcode (trường DISPLAYBARCODE) và FieldMergeBarcode (trường MERGEBARCODE, cũng thực hiện IMergeFieldSurrogate cho mail merge) chia sẻ cùng một tập các thuộc tính cấu hình mã vạch: BarcodeType, BarcodeValue, SymbolHeight, SymbolRotation, ScalingFactor, ForegroundColor, BackgroundColor, PosCodeStyle, CaseCodeStyle, ErrorCorrectionLevel, DisplayText, AddStartStopChar, và FixCheckDigit. Đặt các giá trị này trên thể hiện trường, sau đó gọi Update() để Result phản ánh cấu hình mới trước khi tài liệu được lưu.

Bước 3: Đọc Dữ liệu Trường BARCODE (Bưu chính) Cũ

FieldBarcode triển khai trường BARCODE cũ, là một trường mã vạch bưu chính US (POSTNET) thay vì mã vạch đa năng — nó không chia sẻ các thuộc tính BarcodeType/BarcodeValue từ Bước 2. Thay vào đó, nó công khai PostalAddress (địa chỉ mà mã vạch mã hoá), FacingIdentificationMark, IsUSPostalAddress, và IsBookmark. Kiểm tra Field.Type so với FieldType.FieldBarcode một cách cụ thể trước khi đọc các thuộc tính này, vì việc ép kiểu một trường DISPLAYBARCODE hoặc MERGEBARCODE sang FieldBarcode sẽ không công khai các thuộc tính mà bạn mong đợi.

Bước 4: Kết xuất Hình ảnh Mã vạch bằng Trình tạo Tùy chỉnh

Phiên bản FOSS này chứa dữ liệu trường mã vạch nhưng không bao gồm một động cơ kết xuất mã vạch. BarcodeParameters là container truyền qua hợp nhất các thiết lập từ bất kỳ họ trường mã vạch nào — các thuộc tính DISPLAYBARCODE/MERGEBARCODE từ Bước 2 và các thuộc tính bưu chính từ Bước 3 — thành một đối tượng duy nhất được chuyển cho trình kết xuất. Triển khai IBarcodeGenerator, công khai GetBarcodeImage(parameters) và GetOldBarcodeImage(parameters) legacy, để cung cấp việc thực tế kết xuất hình ảnh; nếu không có triển khai được cung cấp, các trường mã vạch chỉ mang dữ liệu cấu hình.

Bước 5: Làm việc với Các Trường Tương thích Legacy

Bốn lớp khác bao phủ các mã trường cũ vẫn được tìm thấy trong các tệp legacy .docx. FieldBidiOutline triển khai trường BIDIOUTLINE cho việc đánh số đề mục từ phải sang trái và không công khai bất kỳ thuộc tính nào ngoài bề mặt chung Field. FieldEQ triển khai trường phương trình EQ và bổ sung công khai AsOfficeMath() để chuyển nội dung của nó thành một đối tượng OfficeMath — việc này chỉ thành công khi trường thực sự mã hoá một phương trình. FieldFootnoteRef triển khai trường FOOTNOTEREF, trường này tham chiếu chéo một dấu chú thích dưới footnote hoặc endnote, và cũng không công khai bất kỳ thuộc tính nào ngoài bề mặt chung Field. FieldInfo triển khai trường INFO, đọc hoặc ghi một thuộc tính thông tin tóm tắt tài liệu thông qua các thuộc tính InfoType và NewValue của nó.

Bước 6: Cập nhật hoặc Đóng băng Giá trị của Trường Chuyển tiếp

Mỗi lớp trường chuyển tiếp kế thừa GetFieldCode() (văn bản mã nguồn cơ bản của trường), Update() (tính lại kết quả), Unlink() (thay thế trường bằng kết quả đã tính cuối cùng dưới dạng văn bản tĩnh), và Remove() (xóa trường). Gọi Update() sau khi thay đổi cấu hình bất kỳ trường nào để Result phản ánh thay đổi, và sử dụng Unlink() khi giá trị hiện tại của trường nên được đóng băng thay vì vẫn có thể tính lại.