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

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 Anwendungsebene Microsoft Office-Version Excel 2007 PowerPoint 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 Anwendungsebene

Microsoft Office-Version

Excel 2007
PowerPoint 2007
Word 2007

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

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.

So fügen Sie einer Excel-Arbeitsmappe einen benutzerdefinierten XML-Abschnitt 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.

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 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 von einem Ereignishandler des Microsoft.Office.Interop.Excel.Application.WorkbookOpen-Ereignisses 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.

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 Microsoft.Office.Interop.Word.Application.DocumentOpen-Ereignisses aus auf.

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

Fügen Sie der Microsoft.Office.Core.CustomXMLParts-Auflistung in der Präsentation ein neues Microsoft.Office.Core.CustomXMLPart-Objekt hinzu. Der Microsoft.Office.Core.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 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 Präsentation öffnet, rufen Sie die Methode von einem Ereignishandler des Microsoft.Office.Interop.PowerPoint.Application.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