Phạm vi thẻ tài liệu có cấu trúc Bắt đầu ánh xạ Xml

Giới thiệu

Bạn đã bao giờ muốn chèn dữ liệu XML động vào một tài liệu Word chưa? Vâng, bạn thật may mắn! Aspose.Words cho .NET giúp nhiệm vụ này trở nên dễ dàng. Trong hướng dẫn này, chúng ta sẽ đi sâu vào ánh xạ XML bắt đầu phạm vi thẻ tài liệu có cấu trúc. Tính năng này cho phép bạn liên kết các phần XML tùy chỉnh với các điều khiển nội dung, đảm bảo nội dung tài liệu của bạn cập nhật liền mạch với dữ liệu XML của bạn. Sẵn sàng biến tài liệu của bạn thành những kiệt tác động.

Điều kiện tiên quyết

Trước khi bắt đầu phần mã hóa, hãy đảm bảo rằng bạn có mọi thứ cần thiết:

  1. Aspose.Words cho Thư viện .NET: Đảm bảo bạn có phiên bản mới nhất. Bạn có thể tải xuốngđây.
  2. Môi trường phát triển: Visual Studio hoặc bất kỳ IDE nào khác hỗ trợ C#.
  3. Kiến thức cơ bản về C#: Phải quen thuộc với lập trình C#.
  4. Tài liệu Word: Một mẫu tài liệu Word để làm việc.

Nhập không gian tên

Trước tiên, hãy nhập các không gian tên cần thiết. Điều này sẽ đảm bảo chúng ta có quyền truy cập vào tất cả các lớp và phương thức cần thiết trong Aspose.Words cho .NET.

using System;
using Aspose.Words;
using Aspose.Words.Markup;
using System.Text;

Bước 1: Thiết lập thư mục tài liệu của bạn

Mọi dự án đều cần một nền tảng, đúng không? Ở đây, chúng tôi thiết lập đường dẫn đến thư mục tài liệu của bạn.

// Đường dẫn đến thư mục tài liệu của bạn
string dataDir = "YOUR DOCUMENT DIRECTORY";

Bước 2: Tải tài liệu Word

Tiếp theo, chúng ta tải tài liệu Word. Đây là tài liệu mà chúng ta sẽ chèn dữ liệu XML.

Document doc = new Document(dataDir + "Multi-section structured document tags.docx");

Bước 3: Thêm phần XML tùy chỉnh

Chúng ta cần xây dựng một phần XML chứa dữ liệu mà chúng ta muốn chèn và thêm nó vào bộ sưu tập CustomXmlPart của tài liệu. Phần XML tùy chỉnh này sẽ đóng vai trò là nguồn dữ liệu cho các thẻ tài liệu có cấu trúc của chúng ta.

Tạo một phần XML

Đầu tiên, tạo một ID duy nhất cho phần XML và xác định nội dung của nó.

// Xây dựng một phần XML chứa dữ liệu và thêm nó vào bộ sưu tập CustomXmlPart của tài liệu.
string xmlPartId = Guid.NewGuid().ToString("B");
string xmlPartContent = "<root><text>Text element #1</text><text>Text element #2</text></root>";
CustomXmlPart xmlPart = doc.CustomXmlParts.Add(xmlPartId, xmlPartContent);

Xác minh nội dung phần XML

Để đảm bảo phần XML được thêm chính xác, chúng tôi in nội dung của phần đó.

Console.WriteLine(Encoding.UTF8.GetString(xmlPart.Data));

Bước 4: Tạo thẻ tài liệu có cấu trúc

Thẻ tài liệu có cấu trúc (SDT) là một điều khiển nội dung có thể liên kết với một phần XML. Ở đây, chúng tôi tạo một SDT sẽ hiển thị nội dung của phần XML tùy chỉnh của chúng tôi.

Đầu tiên, hãy xác định vị trí bắt đầu phạm vi SDT trong tài liệu.

StructuredDocumentTagRangeStart sdtRangeStart = (StructuredDocumentTagRangeStart)doc.GetChild(NodeType.StructuredDocumentTagRangeStart, 0, true);

Bước 5: Thiết lập ánh xạ XML cho SDT

Bây giờ, đã đến lúc liên kết phần XML của chúng ta với SDT. Bằng cách thiết lập ánh xạ XML, chúng ta chỉ định phần nào của dữ liệu XML sẽ được hiển thị trong SDT.

XPath trỏ đến phần tử cụ thể trong phần XML mà chúng ta muốn hiển thị. Ở đây, chúng ta trỏ đến phần tử thứ hai<text> phần tử trong<root> yếu tố.

// Đặt ánh xạ cho StructuredDocumentTag của chúng tôi
sdtRangeStart.XmlMapping.SetMapping(xmlPart, "/root[1]/text[2]", null);

Bước 6: Lưu tài liệu

Cuối cùng, hãy lưu tài liệu để xem những thay đổi đang diễn ra. SDT trong tài liệu Word bây giờ sẽ hiển thị nội dung XML đã chỉ định.

doc.Save(dataDir + "WorkingWithSdt.StructuredDocumentTagRangeStartXmlMapping.docx");

Phần kết luận

Và bạn đã có nó! Bạn đã ánh xạ thành công một phần XML vào thẻ tài liệu có cấu trúc trong tài liệu Word bằng Aspose.Words cho .NET. Tính năng mạnh mẽ này cho phép bạn tạo các tài liệu động và dựa trên dữ liệu một cách dễ dàng. Cho dù bạn đang tạo báo cáo, hóa đơn hay bất kỳ loại tài liệu nào khác, ánh xạ XML có thể hợp lý hóa đáng kể quy trình làm việc của bạn.

Câu hỏi thường gặp

Thẻ tài liệu có cấu trúc trong Word là gì?

Thẻ tài liệu có cấu trúc, còn được gọi là điều khiển nội dung, là các thùng chứa cho các loại nội dung cụ thể trong tài liệu Word. Chúng có thể được sử dụng để liên kết dữ liệu, hạn chế chỉnh sửa hoặc hướng dẫn người dùng tạo tài liệu.

Làm thế nào tôi có thể cập nhật nội dung phần XML một cách động?

Bạn có thể cập nhật nội dung phần XML bằng cách sửa đổixmlPartContent chuỗi trước khi thêm nó vào tài liệu. Chỉ cần cập nhật chuỗi với dữ liệu mới và thêm nó vàoCustomXmlParts bộ sưu tập.

Tôi có thể liên kết nhiều phần XML với các SDT khác nhau trong cùng một tài liệu không?

Có, bạn có thể liên kết nhiều phần XML với các SDT khác nhau trong cùng một tài liệu. Mỗi SDT có thể có phần XML và ánh xạ XPath riêng.

Có thể ánh xạ các cấu trúc XML phức tạp vào SDT không?

Chắc chắn rồi! Bạn có thể ánh xạ các cấu trúc XML phức tạp vào SDT bằng cách sử dụng các biểu thức XPath chi tiết trỏ chính xác đến các phần tử mong muốn trong phần XML.

Làm thế nào để xóa một phần XML khỏi tài liệu?

Bạn có thể xóa một phần XML bằng cách gọiRemove phương pháp trênCustomXmlParts bộ sưu tập, vượt quaxmlPartId của phần XML mà bạn muốn xóa.