VSTO Eklentilerini kullanarak belgelere özel XML bölümleri ekleme

BIR VSTO Eklentisinde özel XML bölümü oluşturarak XML verilerini aşağıdaki belge türlerinde depolayabilirsiniz:

• Microsoft Office Excel çalışma kitabı.

• Microsoft Office Word belgesi.

• Microsoft Office PowerPoint sunusu.

  Daha fazla bilgi için bkz . Özel XML bölümlerine genel bakış.

  Şunlar için geçerlidir: Bu konudaki bilgiler Excel, PowerPoint ve Word için uygulama düzeyi projeler için geçerlidir. Daha fazla bilgi için bkz. Office uygulaması ve proje türüne göre kullanılabilen özellikler.

Excel çalışma kitabına özel XML bölümü eklemek için

1. Çalışma kitabındaki koleksiyona CustomXMLParts yeni CustomXMLPart bir nesne ekleyin. , CustomXMLPart çalışma kitabında depolamak istediğiniz XML dizesini içerir.

   Aşağıdaki kod örneği, belirtilen çalışma kitabına özel bir XML bölümü ekler.

   C#

   private void AddCustomXmlPartToWorkbook(Excel.Workbook workbook)
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"http://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);
   }
   

   VB

   Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook)
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees xmlns=""http://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
   

2. AddCustomXmlPartToWorkbook Yöntemini ThisAddIn Excel için VSTO Eklenti projesinde sınıfına ekleyin.

3. Projenizdeki diğer kodlardan yöntemini çağırın. Örneğin, kullanıcı çalışma kitabını açtığında özel XML bölümünü oluşturmak için, olay için bir olay işleyicisinden yöntemini çağırın WorkbookOpen .

Word belgesine özel XML bölümü eklemek için

1. Belgedeki koleksiyona CustomXMLParts yeni CustomXMLPart bir nesne ekleyin. , CustomXMLPart belgede depolamak istediğiniz XML dizesini içerir.

   Aşağıdaki kod örneği, belirtilen belgeye özel bir XML bölümü ekler.

   C#

   private void AddCustomXmlPartToActiveDocument(Word.Document document)
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"http://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);
   }
   

   VB

   Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document)
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees xmlns=""http://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
   

2. AddCustomXmlPartToDocument word için vsto eklenti projesinde sınıfına yöntemini ThisAddIn ekleyin.

3. Projenizdeki diğer kodlardan yöntemini çağırın. Örneğin, kullanıcı bir belgeyi açtığında özel XML bölümünü oluşturmak için, olay için bir olay işleyicisinden yöntemini çağırın DocumentOpen .

PowerPoint sunusna özel XML bölümü eklemek için

1. Sunudaki Microsoft.Office.Interop.PowerPoint._Presentation.CustomXMLParts koleksiyonuna yeni CustomXMLPart bir nesne ekleyin. , CustomXMLPart sunuda depolamak istediğiniz XML dizesini içerir.

   Aşağıdaki kod örneği, belirtilen sunuya özel bir XML bölümü ekler.

   C#

   private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation)
   {
       string xmlString =
           "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
           "<employees xmlns=\"http://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);
   }
   

   VB

   Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation)
       Dim xmlString As String = _
           "<?xml version=""1.0"" encoding=""utf-8"" ?>" & _
               "<employees xmlns=""http://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
   

2. AddCustomXmlPartToPresentation Yöntemini ThisAddIn PowerPoint için vsto eklenti projesinde sınıfına ekleyin.

3. Projenizdeki diğer kodlardan yöntemini çağırın. Örneğin, kullanıcı sunuyu açtığında özel XML bölümünü oluşturmak için Microsoft.Office.Interop.PowerPoint.EApplication_Event.AfterPresentationOpen olayı için bir olay işleyicisinden yöntemini çağırın.

Sağlam programlama

Kolaylık olması için, bu örnekte yönteminde yerel değişken olarak tanımlanan bir XML dizesi kullanılır. Normalde XML'yi dosya veya veritabanı gibi bir dış kaynaktan almanız gerekir.

İlgili içerik

• Özel XML bölümlerine genel bakış
• Nasıl yapılır: Belge düzeyinde özelleştirmelere özel XML bölümleri ekleme