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

Artikel
08/10/2011

Sie können XML-Daten in einem der folgenden Dokumenttypen speichern, indem Sie einen benutzerdefinierten XML-Abschnitt in einem Add-In auf Anwendungsebene erstellen:

Microsoft Office Excel-Arbeitsmappe
Microsoft Office Word-Dokument
Microsoft Office PowerPoint-Präsentation

Weitere Informationen finden Sie unter Übersicht über benutzerdefinierte XML-Abschnitte.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Anwendungsebene für die folgenden Anwendungen: Excel 2007 und Excel 2010, PowerPoint 2007 und PowerPoint 2010, Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

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

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

Im folgenden Codebeispiel wird ein benutzerdefinierter XML-Abschnitt einer angegebenen Arbeitsmappe hinzugefügt.

Private Sub AddCustomXmlPartToWorkbook(ByVal workbook As Excel.Workbook)
    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 = _
        workbook.CustomXMLParts.Add(xmlString)
End Sub

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

Fügen Sie die AddCustomXmlPartToWorkbook-Methode der ThisAddIn-Klasse in einem Projekt auf Anwendungsebene für Excel 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 von einem Ereignishandler des WorkbookOpen-Ereignisses aus auf.

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

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

Im folgenden Codebeispiel wird ein benutzerdefinierter XML-Abschnitt einem angegebenen Dokument hinzugefügt.

Private Sub AddCustomXmlPartToActiveDocument(ByVal document As Word.Document)
    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 = _
        document.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToActiveDocument(Word.Document document)
{
    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 = document.CustomXMLParts.Add(xmlString, missing);
}

Fügen Sie die AddCustomXmlPartToDocument-Methode der ThisAddIn-Klasse in einem Projekt auf Anwendungsebene 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 ein Dokument öffnet, rufen Sie die Methode von einem Ereignishandler des DocumentOpen-Ereignisses aus auf.

So fügen Sie einer PowerPoint-Präsentation einen benutzerdefinierten XML-Abschnitt hinzu

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

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

Private Sub AddCustomXmlPartToPresentation(ByVal presentation As PowerPoint.Presentation)
    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 = _
        presentation.CustomXMLParts.Add(xmlString)
End Sub

private void AddCustomXmlPartToPresentation(PowerPoint.Presentation presentation)
{
    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 = 
        presentation.CustomXMLParts.Add(xmlString, missing);
}

Fügen Sie die AddCustomXmlPartToPresentation-Methode der ThisAddIn-Klasse in einem Projekt auf Anwendungsebene für PowerPoint hinzu.
Rufen Sie die Methode von anderem Code im Projekt aus auf. Um beispielsweise den benutzerdefinierten XML-Abschnitt zu erstellen, wenn der Benutzer die Präsentation öffnet, rufen Sie die Methode von einem Ereignishandler des AfterPresentationOpen-Ereignisses aus auf.

Robuste Programmierung

Der Einfachheit halber wird in diesem Beispiel eine XML-Zeichenfolge verwendet, die als 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 Anpassungen auf Dokumentebene

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

Konzepte

Übersicht über benutzerdefinierte XML-Abschnitte

Freigeben über