Gewusst wie: Hinzufügen von benutzerdefinierten XML-Abschnitten zu Anpassungen auf Dokumentebene

Artikel
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Microsoft Office-Version Excel 2007 Word 2007 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

Projekte auf Dokumentebene

Microsoft Office-Version

Excel 2007
Word 2007

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

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

Hinweis:
Visual Studio Tools for Office stellt keine Projekte auf Dokumentebene für Microsoft Office PowerPoint bereit. Informationen zum Hinzufügen eines benutzerdefinierten XML-Abschnitts zu einer PowerPoint-Präsentation mithilfe eines Add-Ins auf Anwendungsebene finden Sie unter Gewusst wie: Hinzufügen von benutzerdefinierten XML-Abschnitten zu Dokumenten mithilfe von Add-Ins auf Anwendungsebene.

So fügen Sie einen benutzerdefinierten XML-Abschnitt zu einer Excel-Arbeitsmappe hinzu

Fügen Sie der Microsoft.Office.Core.CustomXMLParts-Auflistung in der Arbeitsmappe ein neues Microsoft.Office.Core.CustomXMLPart-Objekt hinzu. Der Microsoft.Office.Core.CustomXMLPart enthält die XML-Zeichenfolge, die Sie in der Arbeitsmappe speichern möchten.

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

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

Fügen Sie die AddCustomXmlPartToWorkbook-Methode der ThisWorkbook-Klasse in einem Projekt auf Dokumentebene für Excel 2007 hinzu.
Rufen Sie die Methode von anderem Code im Projekt aus auf. Um beispielsweise den benutzerdefinierten XML-Abschnitt zu erstellen, wenn der Benutzer die Arbeitsmappe öffnet, rufen Sie die Methode vom ThisWorkbook_Startup-Ereignishandler aus auf.

So fügen Sie einem Word-Dokument einen benutzerdefinierten XML-Abschnitt hinzu

Fügen Sie der Microsoft.Office.Core.CustomXMLParts-Auflistung im Dokument ein neues Microsoft.Office.Core.CustomXMLPart-Objekt hinzu. Der Microsoft.Office.Core.CustomXMLPart enthält die XML-Zeichenfolge, die Sie im Dokument speichern möchten.

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

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

Fügen Sie die AddCustomXmlPartToDocument-Methode der ThisDocument-Klasse in einem Projekt auf Dokumentebene für Word 2007 hinzu.
Rufen Sie die Methode von anderem Code im Projekt aus auf. Um beispielsweise den benutzerdefinierten XML-Abschnitt zu erstellen, wenn der Benutzer das Dokument öffnet, rufen Sie die Methode vom ThisDocument_Startup-Ereignishandler aus auf.

Robuste Programmierung

Der Einfachheit halber wird in diesem Beispiel eine XML-Zeichenfolge verwendet, die als eine lokale Variable in der Methode definiert ist. Normalerweise sollten Sie den XML-Code von einer externen Quelle erhalten, z. B. einer Datei oder einer Datenbank.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von benutzerdefinierten XML-Abschnitten zu Dokumenten mithilfe von Add-Ins auf Anwendungsebene

Gewusst wie: Hinzufügen von benutzerdefinierten XML-Abschnitten zu Dokumenten, ohne Microsoft Office zu starten

Konzepte

Übersicht über benutzerdefinierte XML-Abschnitte

Freigeben über