Ikat SDT ke Bagian Xml Khusus

Tutorial ini menunjukkan cara mengikat Tag Dokumen Terstruktur (SDT) ke Bagian Xml Kustom menggunakan Aspose.Words untuk .NET. SDT memungkinkan Anda menambahkan kontrol konten terstruktur ke dokumen Word, dan CustomXmlParts menyediakan cara untuk menyimpan data XML khusus yang terkait dengan dokumen tersebut.

Prasyarat

Untuk mengikuti tutorial ini, Anda harus memiliki yang berikut ini:

  • Aspose.Words untuk perpustakaan .NET diinstal.
  • Pengetahuan dasar tentang C# dan XML.

Langkah 1: Siapkan Direktori Dokumen

Mulailah dengan menyiapkan jalur ke direktori dokumen Anda. Mengganti"YOUR DOCUMENT DIRECTORY" dengan jalur sebenarnya ke direktori tempat Anda ingin menyimpan dokumen.

string dataDir = "YOUR DOCUMENT DIRECTORY";

Langkah 2: Buat Dokumen dan CustomXmlPart

Buat instance baru dariDocument kelas dan aCustomXmlPart untuk menyimpan data XML khusus. XML khusus harus dalam format XML yang valid. Dalam contoh ini, kami menggunakan string XML sederhana<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>");

Langkah 3: Tambahkan StructuredDocumentTag (SDT) ke Dokumen

Tambah sebuahStructuredDocumentTag ke dokumen untuk berfungsi sebagai kontrol konten. TentukanSdtType sebagaiPlainText dan ituMarkupLevel sebagaiBlock untuk membuat SDT tingkat blok.

StructuredDocumentTag sdt = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(sdt);

Langkah 4: Atur Pemetaan XML untuk SDT

Petakan SDT keCustomXmlPart dengan menggunakanSetMapping metodeXmlMapping Properti. TentukanCustomXmlPart , ekspresi XPath untuk menemukan node XML yang diinginkan, dan awalan namespace jika diperlukan. Dalam contoh ini, kami memetakan SDT ke/root[1]/text[1].

sdt.XmlMapping.SetMapping(xmlPart, "/root[1]/text[1]", "");

Langkah 5: Simpan Dokumen

Simpan dokumen yang dimodifikasi ke direktori yang ditentukan menggunakanSave metode. Berikan nama file yang diinginkan dengan ekstensi file yang sesuai. Dalam contoh ini, kami menyimpan dokumen sebagai “WorkingWithSdt.BindSDTtoCustomXmlPart.doc”.

doc.Save(dataDir + "WorkingWithSdt.BindSDTtoCustomXmlPart.doc");

Contoh kode sumber untuk Bind Sd Tto Custom Xml Part menggunakan Aspose.Words untuk .NET

	// Jalur ke direktori dokumen Anda
	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");

Itu dia! Anda telah berhasil mengikat SDT ke CustomXmlPart di dokumen Word Anda menggunakan Aspose.Words untuk .NET.