Liên kết SDT với phần Xml tùy chỉnh
Hướng dẫn này trình bày cách liên kết Thẻ tài liệu có cấu trúc (SDT) với Phần Xml tùy chỉnh bằng cách sử dụng Aspose.Words cho .NET. SDT cho phép bạn thêm các điều khiển nội dung có cấu trúc vào tài liệu Word và CustomXmlParts cung cấp cách lưu trữ dữ liệu XML tùy chỉnh được liên kết với tài liệu.
Điều kiện tiên quyết
Để làm theo hướng dẫn này, bạn cần có những điều sau:
- Đã cài đặt thư viện Aspose.Words cho .NET.
- Kiến thức cơ bản về C# và XML.
Bước 1: Thiết lập thư mục tài liệu
Bắt đầu bằng cách thiết lập đường dẫn đến thư mục tài liệu của bạn. Thay thế"YOUR DOCUMENT DIRECTORY"
với đường dẫn thực tế đến thư mục mà bạn muốn lưu tài liệu.
string dataDir = "YOUR DOCUMENT DIRECTORY";
Bước 2: Tạo Tài liệu và CustomXmlPart
Tạo một phiên bản mới củaDocument
lớp học và mộtCustomXmlPart
để lưu trữ dữ liệu XML tùy chỉnh. XML tùy chỉnh phải ở định dạng XML hợp lệ. Trong ví dụ này, chúng tôi sử dụng một chuỗi XML đơn giản<root><text>Hello, World!</text></root>
.
Document doc = new Document();
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(Guid.NewGuid().ToString("B"), "<root><text>Hello, World!</text></root>");
Bước 3: Thêm Thẻ tài liệu có cấu trúc (SDT) vào tài liệu
Thêm mộtStructuredDocumentTag
vào tài liệu để đóng vai trò kiểm soát nội dung. Chỉ định laSdtType
BẰNGPlainText
vàMarkupLevel
BẰNGBlock
để tạo SDT cấp khối.
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);
Bước 4: Đặt ánh xạ XML cho SDT
Ánh xạ SDT tớiCustomXmlPart
bằng cách sử dụngSetMapping
phương pháp củaXmlMapping
tài sản. Chỉ định laCustomXmlPart
, biểu thức XPath để định vị nút XML mong muốn và tiền tố vùng tên nếu cần. Trong ví dụ này, chúng tôi ánh xạ SDT tới/root[1]/text[1]
.
sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");
Bước 5: Lưu tài liệu
Lưu tài liệu đã sửa đổi vào thư mục được chỉ định bằng cách sử dụngSave
phương pháp. Cung cấp tên tệp mong muốn với phần mở rộng tệp thích hợp. Trong ví dụ này, chúng tôi lưu tài liệu dưới dạng “WorkingWithSdt.BindSDTtoCustomXmlPart.doc”.
doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");
Mã nguồn ví dụ cho Bind Sd Tto Custom Xml Part sử dụng Aspose.Words for .NET
// Đường dẫn đến thư mục tài liệu của bạn
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document();
CustomXmlPart xmlPart =
doc.CustomXmlParts.Add(Guid.NewGuid().ToString("B"), "<root><text>Hello, World!</text></root>");
StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);
sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");
doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");
Đó là nó! Bạn đã liên kết thành công SDT với CustomXmlPart trong tài liệu Word của mình bằng Aspose.Words for .NET.