Dodawanie niestandardowych części XML do dokumentów przy użyciu dodatków VSTO

Dane XML można przechowywać w następujących typach dokumentów, tworząc niestandardową część XML w dodatku VSTO:

• Skoroszyt programu Microsoft Office Excel.

• Dokument programu Microsoft Office Word.

• Prezentacja programu Microsoft Office PowerPoint.

  Aby uzyskać więcej informacji, zobacz Omówienie niestandardowych części XML.

  Dotyczy: informacje w tym temacie dotyczą projektów na poziomie aplikacji dla programów Excel, PowerPoint i Word. Aby uzyskać więcej informacji, zobacz Funkcje dostępne przez aplikacja pakietu Office lication i typ projektu.

Aby dodać niestandardową część XML do skoroszytu programu Excel

1. Dodaj nowy CustomXMLPart obiekt do CustomXMLParts kolekcji w skoroszycie. Zawiera CustomXMLPart ciąg XML, który ma być przechowywany w skoroszycie.

   Poniższy przykład kodu dodaje niestandardową część XML do określonego skoroszytu.

   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. Dodaj metodę AddCustomXmlPartToWorkbookThisAddIn do klasy w projekcie dodatku VSTO dla programu Excel.

3. Wywołaj metodę z innego kodu w projekcie. Aby na przykład utworzyć niestandardową część XML po otwarciu skoroszytu przez użytkownika, wywołaj metodę z procedury obsługi zdarzeń dla WorkbookOpen zdarzenia.

Aby dodać niestandardową część XML do dokumentu programu Word

1. Dodaj nowy CustomXMLPart obiekt do CustomXMLParts kolekcji w dokumencie. Zawiera CustomXMLPart ciąg XML, który ma być przechowywany w dokumencie.

   Poniższy przykład kodu dodaje niestandardową część XML do określonego dokumentu.

   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. Dodaj metodę AddCustomXmlPartToDocumentThisAddIn do klasy w projekcie dodatku VSTO dla programu Word.

3. Wywołaj metodę z innego kodu w projekcie. Aby na przykład utworzyć niestandardową część XML po otwarciu dokumentu przez użytkownika, wywołaj metodę z procedury obsługi zdarzeń dla DocumentOpen zdarzenia.

Aby dodać niestandardową część XML do prezentacji programu PowerPoint

1. Dodaj nowy CustomXMLPart obiekt do kolekcji Microsoft.Office.Interop.PowerPoint._Presentation.CustomXMLParts w prezentacji. Zawiera CustomXMLPart ciąg XML, który ma być przechowywany w prezentacji.

   Poniższy przykład kodu dodaje niestandardową część XML do określonej prezentacji.

   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. Dodaj metodę AddCustomXmlPartToPresentationThisAddIn do klasy w projekcie dodatku VSTO dla programu PowerPoint.

3. Wywołaj metodę z innego kodu w projekcie. Aby na przykład utworzyć niestandardową część XML, gdy użytkownik otworzy prezentację, wywołaj metodę z procedury obsługi zdarzeń dla zdarzenia Microsoft.Office.Interop.PowerPoint.EApplication_Event.AfterPresentationOpen .

Niezawodne programowanie

Dla uproszczenia w tym przykładzie użyto ciągu XML zdefiniowanego jako zmienna lokalna w metodzie . Zazwyczaj należy uzyskać kod XML ze źródła zewnętrznego, takiego jak plik lub baza danych.

Powiązana zawartość

• Omówienie niestandardowych części XML
• Instrukcje: dodawanie niestandardowych części XML do dostosowań na poziomie dokumentu