Cách làm việc với XML Markup tùy chỉnh trong .NET

Bước 1: Đọc dữ liệu XML tùy chỉnh từ một tài liệu

Document.CustomXmlParts trả về một CustomXmlPartCollection — cùng cơ chế mà Word sử dụng để hỗ trợ các điều khiển nội dung được ánh xạ XML. Duyệt qua bộ sưu tập, hoặc gọi GetById(id) khi bạn đã biết phần nào bạn cần, để nhận được một CustomXmlPart. Mỗi phần cung cấp Id, một mảng byte Data chứa XML thô, một DataChecksum để phát hiện liệu dữ liệu đã thay đổi mà không cần so sánh toàn bộ byte, và Schemas — một CustomXmlSchemaCollection liệt kê các sơ đồ XML liên quan tới nó.

Bước 2: Thêm hoặc Cập nhật một phần XML tùy chỉnh

Gọi CustomXmlPartCollection.Add(id, xml) với một chuỗi id và nội dung XML để tạo một phần trực tiếp, hoặc tạo một CustomXmlPart riêng biệt và truyền nó cho Add(part). Để xóa dữ liệu, sử dụng RemoveAt(index) trên một vị trí cụ thể hoặc Clear() để loại bỏ mọi phần. Khi sao chép dữ liệu XML tùy chỉnh giữa các tài liệu, sử dụng CustomXmlPart.Clone() (hoặc Clone() của bộ sưu tập) trên phần nguồn thay vì đọc lại và thêm lại XML thô, sau đó thêm bản sao vào Document.CustomXmlParts của tài liệu đích.

Bước 3: Quản lý các Schema được liên kết với một Phần

CustomXmlPart.Schemas đạt tới một CustomXmlSchemaCollection, nó theo dõi các URI schema liên kết với phần dưới dạng chuỗi thuần thay vì các đối tượng schema đã được phân tích. Sử dụng Add(value) để đăng ký một URI schema, Remove(name) hoặc RemoveAt(index) để loại bỏ một, IndexOf(value) để tìm một, và Clear() để xóa hết chúng. Count báo cáo số lượng URI schema hiện đang được liên kết với phần.

Bước 4: Làm việc với Các Phần Tùy chỉnh Cấp Gói

Không phải mọi phần không hiển thị trong một gói OOXML đều là XML tùy chỉnh. Document.PackageCustomParts trả về một CustomPartCollection các đối tượng CustomPart — các phần tùy ý được lưu trong gói, chẳng hạn các phần được thêm bởi một ứng dụng khác đã mở file. Mỗi CustomPart có một Name, ContentType, RelationshipType, một mảng byte Data, và một cờ IsExternal cho biết nó là một tham chiếu bên ngoài thay vì nội dung nhúng. Add(part), RemoveAt(index) và Clear() quản lý bộ sưu tập theo cùng cách như CustomXmlPartCollection. Kiểm tra PackageCustomParts — không phải CustomXmlParts — khi một phần mà tài liệu của bạn nên có không xuất hiện trong bộ sưu tập XML tùy chỉnh.

Bước 5: Kiểm tra Các Thẻ Thông minh Cũ và Thuộc tính của Chúng

SmartTag là một loại nút (NodeType.SmartTag, được tạo bằng SmartTag(doc)) đại diện cho một thẻ thông minh Word cũ được bọc quanh văn bản đã được nhận dạng. Kiểm tra Element và Uri cùng nhau để xác định bộ nhận dạng nào đã tạo thẻ, sau đó đọc Properties — một CustomXmlPropertyCollection — để lấy dữ liệu có cấu trúc mà bộ nhận dạng đã đính kèm. Trong một CustomXmlPropertyCollection, bộ chỉ mục (ví dụ properties["MyProp"]) hoặc Contains(name) tra cứu một thuộc tính cụ thể, IndexOfKey(name) trả về vị trí của nó, và Remove(name)/RemoveAt(index)/Clear() xóa các mục; mỗi CustomXmlProperty được tạo bằng CustomXmlProperty(name, uri, value) và cung cấp Name, Uri, và Value. Vì SmartTag kế thừa từ CompositeNode, nó cũng tham gia vào cây tài liệu như các nút khác, hỗ trợ Accept(visitor), AcceptStart(visitor), và AcceptEnd(visitor) cho việc duyệt dựa trên DocumentVisitor.