ربط SDT بجزء Xml المخصص

يوضح هذا البرنامج التعليمي كيفية ربط علامة الوثيقة المنظمة (SDT) بجزء Xml مخصص باستخدام Aspose.Words لـ .NET. تسمح لك SDTs بإضافة عناصر تحكم المحتوى المنظم إلى مستند Word، وتوفر CustomXmlParts طريقة لتخزين بيانات XML المخصصة المرتبطة بالمستند.

المتطلبات الأساسية

لمتابعة هذا البرنامج التعليمي، يجب أن يكون لديك ما يلي:

• تم تثبيت Aspose.Words لمكتبة .NET.
• المعرفة الأساسية بـ C# وXML.

الخطوة 1: إعداد دليل المستندات

ابدأ بإعداد المسار إلى دليل المستندات الخاص بك. يستبدل"YOUR DOCUMENT DIRECTORY"بالمسار الفعلي إلى الدليل الذي تريد حفظ المستند فيه.

string dataDir = "YOUR DOCUMENT DIRECTORY";

الخطوة 2: إنشاء مستند وCustomXmlPart

إنشاء مثيل جديد لـDocument فئة و أCustomXmlPart لتخزين بيانات XML المخصصة. يجب أن يكون XML المخصص بتنسيق XML صالحًا. في هذا المثال، نستخدم سلسلة XML بسيطة<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>");

الخطوة 3: إضافة StructuredDocumentTag (SDT) إلى المستند

أضفStructuredDocumentTag إلى المستند ليكون بمثابة عنصر تحكم المحتوى. حدد الSdtType مثلPlainText و الMarkupLevel مثلBlock لإنشاء SDT على مستوى الكتلة.

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

الخطوة 4: قم بتعيين تعيين XML لـ SDT

قم بتعيين المعاملة الخاصة والتفضيلية (SDT) إلىCustomXmlPart باستخدامSetMapping طريقةXmlMapping ملكية. حدد الCustomXmlPart وتعبير XPath لتحديد موقع عقدة XML المطلوبة وبادئة مساحة الاسم إذا لزم الأمر. في هذا المثال، نقوم بتعيين المعاملة الخاصة والتفضيلية ل/root[1]/text[1].

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

الخطوة 5: احفظ المستند

احفظ المستند المعدل في الدليل المحدد باستخدام الملفSave طريقة. قم بتوفير اسم الملف المطلوب مع امتداد الملف المناسب. في هذا المثال، نقوم بحفظ المستند باسم “WorkingWithSdt.BindSDTtoCustomXmlPart.doc”.

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

مثال على التعليمات البرمجية المصدر لجزء Bind Sd Tto Custom Xml باستخدام Aspose.Words لـ .NET

	// المسار إلى دليل المستندات الخاص بك
	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");

هذا كل شيء! لقد نجحت في ربط SDT بـ CustomXmlPart في مستند Word الخاص بك باستخدام Aspose.Words for .NET.