كيفية القيام بما يلي: إضافة أجزاء XML المخصصة إلى ‏‫تخصيصات على مستوى المستند

ينطبق على
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع مشروعات على مستوى المستند إصدار Microsoft Office Excel 2007 و Excel 2010 Word 2007 و Word 2010

يمكنك تخزين بيانات XML في مصنف Microsoft Office Excel أو مستند Microsoft Office Word بواسطة إنشاء جزء XML مخصص في تخصيص علي مستوي المستند. لمزيد من المعلومات، راجع نظرة عامة على أجزاء XML.

ملاحظة

لا يوفر Visual Studio مشاريع علي مستوى المستند لـ Microsoft Office PowerPoint. لمزيد من المعلومات حول إضافة جزء XML مخصص إلى عرض PowerPoint تقديمي باستخدام وظيفة إضافية علي مستوي التطبيق, راجع كيفية القيام بما يلي: إضافة أجزاء XML مخصصة إلى مستندات باستخدام وظيفة إضافية على مستوى التطبيق.

لإضافة جزء XML مخصص إلى مصنف Excel

1. قم بإضافة كائن Microsoft.Office.Core.CustomXMLPart جديد إلى مجموعة Microsoft.Office.Core.CustomXMLParts في المصنف. يحتوي Microsoft.Office.Core.CustomXMLPart على سلسلة XML التى تريد تخزينها في المصنف.

   Private Sub AddCustomXmlPartToWorkbook()
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                   "<employee>" & _
                       "<name>Karina Leal</name>" & _
                       "<hireDate>1999-04-01</hireDate>" & _
                       "<title>Manager</title>" & _
                   "</employee>" & _
               "</employees>"
       Dim employeeXMLPart As Office.CustomXMLPart = Me.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToWorkbook()
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
               "<employee>" +
                   "<name>Karina Leal</name>" +
                   "<hireDate>1999-04-01</hireDate>" +
                   "<title>Manager</title>" +
               "</employee>" +
           "</employees>";
   
       Office.CustomXMLPart employeeXMLPart = this.CustomXMLParts.Add(xmlString, missing);
   }
   

2. قم بإضافة الأسلوب AddCustomXmlPartToWorkbook إلى فئة ThisWorkbook في مشروع على مستوى التطبيق لـ Excel.

3. قم باستدعاء الأسلوب من تعليمات برمجية أخرى في مشروعك. على سبيل المثال، لإنشاء جزء XML مخصص عندما يقوم المستخدم بفتح مصنف، قم باستدعاء الأسلوب من معالج الأحداث ThisWorkbook_Startup.

لإضافة جزء XML مخصص إلى مستند Word

1. قم بإضافة كائن Microsoft.Office.Core.CustomXMLPart جديد إلى مجموعة Microsoft.Office.Core.CustomXMLParts في المستند. يحتوي Microsoft.Office.Core.CustomXMLPart على سلسلة XML التى تريد تخزينها في المستند.

   Private Sub AddCustomXmlPartToDocument()
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees https://schemas.microsoft.com/vsto/samples"">" & _
                   "<employee>" & _
                       "<name>Karina Leal</name>" & _
                       "<hireDate>1999-04-01</hireDate>" & _
                       "<title>Manager</title>" & _
                   "</employee>" & _
               "</employees>"
   
       Dim employeeXMLPart As Office.CustomXMLPart = _
           Me.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToDocument()
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"https://schemas.microsoft.com/vsto/samples\">" +
               "<employee>" +
                   "<name>Karina Leal</name>" +
                   "<hireDate>1999-04-01</hireDate>" +
                   "<title>Manager</title>" +
               "</employee>" +
           "</employees>";
   
       Office.CustomXMLPart employeeXMLPart = this.CustomXMLParts.Add(xmlString, missing);
   }
   

2. قم بإضافة الأسلوب AddCustomXmlPartToDocument إلى فئة ThisDocument في مشروع على مستوى التطبيق لـ Word.

3. قم باستدعاء الأسلوب من تعليمات برمجية أخرى في مشروعك. على سبيل المثال، لإنشاء جزء XML مخصص عندما يقوم المستخدم بفتح مستند، قم باستدعاء الأسلوب من معالج الأحداث ThisDocument_Startup.

برمجة نشطة

ببساطة، هذا المثال يستخدم سلسلة XML يتم تعريفها على أنها متغير محلي في الأسلوب. بشكل عام، يجب الحصول على XML من مصدر خارجي، مثل ملف أو قاعدة بيانات.

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة أجزاء XML مخصصة إلى مستندات باستخدام وظيفة إضافية على مستوى التطبيق

كيفية القيام بما يلي: إضافة أجزاء XML المخصصة إلى المستندات بدون بدء تشغيل Microsoft Office

المبادئ

نظرة عامة على أجزاء XML