Hinzufügen von benutzerdefinierten XML-Komponenten zu Anpassungen auf Dokumentebene

Sie können XML-Daten in einer Microsoft Office Excel-Arbeitsmappe oder in einem Microsoft Office Word-Dokument speichern, indem Sie einen benutzerdefinierten XML-Abschnitt in einer Anpassung auf Dokumentebene erstellen. Weitere Informationen finden Sie in der Übersicht über benutzerdefinierte XML-Komponenten.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel und Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Hinweis

Visual Studio stellt keine Projekte auf Dokumentebene für Microsoft Office PowerPoint bereit. Informationen zum Hinzufügen einer benutzerdefinierten XML-Komponente zu einer PowerPoint-Präsentation mithilfe eines VSTO-Add-Ins finden Sie unter How to: Add-ins custom XML parts to documents by using VSTO Add-ins.

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.

   C#

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

   VB

   Private Sub AddCustomXmlPartToWorkbook()
       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 = Me.CustomXMLParts.Add(xmlString)
   End Sub
   

2. Fügen Sie die AddCustomXmlPartToWorkbook -Methode der ThisWorkbook -Klasse in einem Projekt auf Dokumentebene für Excel hinzu.

3. Rufen Sie die Methode aus anderem Code in Ihrem Projekt auf. Um z. B. das benutzerdefinierte XML-Element zu erstellen, wenn der Benutzer eine Arbeitsmappe öffnet, rufen Sie die Methode über den ThisWorkbook_Startup -Ereignishandler 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.

   C#

   private void AddCustomXmlPartToDocument()
   {
       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 = this.CustomXMLParts.Add(xmlString, missing);
   }
   

   VB

   Private Sub AddCustomXmlPartToDocument()
       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 = _
           Me.CustomXMLParts.Add(xmlString)
   End Sub
   

2. Fügen Sie die AddCustomXmlPartToDocument -Methode der ThisDocument -Klasse in einem Projekt auf Dokumentebene für Word hinzu.

3. Rufen Sie die Methode aus anderem Code in Ihrem Projekt auf. Um z. B. das benutzerdefinierte XML-Element zu erstellen, wenn der Benutzer ein Dokument öffnet, rufen Sie die Methode über den ThisDocument_Startup -Ereignishandler 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 Dokumenten mithilfe von VSTO-Add-Ins