Hinzufügen von benutzerdefinierten XML-Komponenten zu Dokumenten mithilfe von VSTO-Add-Ins

Sie können XML-Daten in folgenden Dokumenttypen speichern, indem Sie ein benutzerdefiniertes XML-Element in einem VSTO-Add-In erstellen:

• Microsoft Office Excel-Arbeitsmappe

• Microsoft Office Word-Dokument

• Microsoft Office PowerPoint-Präsentation

  Weitere Informationen finden Sie in der Übersicht über benutzerdefinierte XML-Komponenten.

  Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für Excel, PowerPoint und Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

So fügen Sie einer Excel-Arbeitsmappe ein benutzerdefiniertes XML-Element hinzu

1. Fügen Sie der CustomXMLPart -Auflistung in der Arbeitsmappe ein neues CustomXMLParts -Objekt hinzu. Die XML-Zeichenfolge, die Sie in der Arbeitsmappe speichern möchten, ist in CustomXMLPart enthalten.

   Im folgenden Codebeispiel wird einer angegebenen Arbeitsmappe ein benutzerdefiniertes XML-Element hinzugefügt.

   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. Fügen Sie die AddCustomXmlPartToWorkbook Methode der ThisAddIn Klasse in einem VSTO-Add-In-Projekt für Excel hinzu.

3. Rufen Sie die Methode aus anderem Code in Ihrem Projekt auf. Um das benutzerdefinierte XML-Element beispielsweise zu erstellen, wenn der Benutzer eine Arbeitsmappe öffnet, rufen Sie die Methode von einem Ereignishandler für das WorkbookOpen -Ereignis auf.

So fügen Sie einem Word-Dokument ein benutzerdefiniertes XML-Element hinzu

1. Fügen Sie der CustomXMLPart -Auflistung im Dokument ein neues CustomXMLParts -Objekt hinzu. Die XML-Zeichenfolge, die Sie im Dokument speichern möchten, ist in CustomXMLPart enthalten.

   Im folgenden Codebeispiel wird einem angegebenen Dokument ein benutzerdefiniertes XML-Element hinzugefügt.

   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. Fügen Sie die AddCustomXmlPartToDocument Methode der ThisAddIn Klasse in einem VSTO-Add-In-Projekt für Word hinzu.

3. Rufen Sie die Methode aus anderem Code in Ihrem Projekt auf. Um das benutzerdefinierte XML-Element beispielsweise zu erstellen, wenn der Benutzer ein Dokument öffnet, rufen Sie die Methode von einem Ereignishandler für das DocumentOpen -Ereignis auf.

So fügen Sie einer PowerPoint-Präsentation ein benutzerdefiniertes XML-Element hinzu

1. Fügen Sie der Microsoft.Office.Interop.PowerPoint._Presentation.CustomXMLParts-Auflistung in der Präsentation ein neues CustomXMLPart Objekt hinzu. Die XML-Zeichenfolge, die Sie in der Präsentation speichern möchten, ist in CustomXMLPart enthalten.

   Im folgenden Codebeispiel wird einer angegebenen Präsentation ein benutzerdefiniertes XML-Element hinzugefügt.

   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. Fügen Sie die AddCustomXmlPartToPresentation Methode der ThisAddIn Klasse in einem VSTO-Add-In-Projekt für PowerPoint hinzu.

3. Rufen Sie die Methode aus anderem Code in Ihrem Projekt auf. Um beispielsweise beim Öffnen einer Präsentation die benutzerdefinierte XML-Komponente zu erstellen, rufen Sie die Methode aus einem Ereignishandler für das ereignis Microsoft.Office.Interop.PowerPoint.EApplication_Event.AfterPresentationOpen auf.

Stabile Programmierung

Zur Vereinfachung verwendet dieses Beispiel eine XML-Zeichenfolge, die als lokale Variable in der Methode definiert ist. In der Regel sollten Sie den XML-Code aus einer externen Quelle, z. B. einer Datei oder Datenbank, abrufen.

Zugehöriger Inhalt

• Übersicht über benutzerdefinierte XML-Komponenten
• Vorgehensweise: Hinzufügen von benutzerdefinierten XML-Komponenten zu Anpassungen auf Dokumentebene