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

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

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

• مصنف Microsoft Office Excel 2007.

• مستند Microsoft Office Word 2007.

• عرض تقديمى لـ Microsoft Office PowerPoint 2007.

لمزيد من المعلومات، راجع نظرة عامة على أجزاء XML.

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

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

   مثال التعليمات البرمجية التالي يضيف جزء XML مخصص إلى مصنف محدد.

   Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook)
       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 = _
           workbook.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToWorkbook(Excel.Workbook workbook)
   {
       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 = workbook.CustomXMLParts.Add(xmlString, missing);
   }
   

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

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

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

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

   مثال التعليمات البرمجية التالي يضيف جزء XML مخصص إلى مستند محدد.

   Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document)
       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 = _
           document.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToActiveDocument(Word.Document document)
   {
       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 = document.CustomXMLParts.Add(xmlString, missing);
   }
   

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

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

لإضافة جزء XML مخصص إلى عرض تقديمي لـ PowerPoint

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

   مثال التعليمات البرمجية التالي يضيف جزء XML مخصص إلى عرض محدد.

   Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation)
       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 = _
           presentation.CustomXMLParts.Add(xmlString)
   End Sub
   

   private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation)
   {
       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 = 
           presentation.CustomXMLParts.Add(xmlString, missing);
   }
   

2. قم بإضافة الأسلوب AddCustomXmlPartToPresentation إلى الفئة ThisAddIn في مشروع على مستوى التطبيق لـ PowerPoint.

3. قم باستدعاء الأسلوب من تعليمات برمجية أخرى في مشروعك. على سبيل المثال، لإنشاء جزء XML مخصص عندما يقوم المستخدم بفتح عرض، قم باستدعاء الأسلوب من معالج الأحداث للحدث Microsoft.Office.Interop.PowerPoint.Application.AfterPresentationOpen.

برمجة نشطة

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

راجع أيضًا:

المهام

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

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

المبادئ

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