Comment : ajouter des parties XML personnalisées à des documents à l'aide de compléments VSTOHow to: Add Custom XML Parts to Documents by Using VSTO Add-Ins

Vous pouvez stocker des données XML dans les types suivants de documents en créant une partie XML personnalisée dans un complément VSTO :You can store XML data in the following types of documents by creating a custom XML part in a VSTO Add-in:

Pour ajouter une partie XML personnalisée à un classeur ExcelTo add a custom XML part to an Excel workbook

  1. Ajoutez un nouvel objet CustomXMLPart à la collection Microsoft.Office.Interop.Excel._Workbook.CustomXMLParts* figurant dans le classeur.Add a new CustomXMLPart object to the Microsoft.Office.Interop.Excel._Workbook.CustomXMLParts* collection in the workbook. CustomXMLPart contient la chaîne XML que vous souhaitez stocker dans le classeur.The CustomXMLPart contains the XML string that you want to store in the workbook.

    L'exemple de code suivant ajoute une partie XML personnalisée à un classeur spécifié.The following code example adds a custom XML part to a specified workbook.

    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
    
    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);
    }
    
  2. Ajoutez la méthode AddCustomXmlPartToWorkbook à la classe ThisAddIn dans un projet de complément VSTO pour Excel.Add the AddCustomXmlPartToWorkbook method to the ThisAddIn class in an VSTO Add-in project for Excel.

  3. Appelez cette méthode à partir d'un autre code dans votre projet.Call the method from other code in your project. Par exemple, pour créer la partie XML personnalisée quand l'utilisateur ouvre un classeur, appelez la méthode à partir d'un gestionnaire d'événements pour l'événement Microsoft.Office.Interop.Excel.AppEvents_Event.WorkbookOpen .For example, to create the custom XML part when the user opens a workbook, call the method from an event handler for the Microsoft.Office.Interop.Excel.AppEvents_Event.WorkbookOpen event.

Pour ajouter une partie XML personnalisée à un document WordTo add a custom XML part to a Word document

  1. Ajoutez un nouvel objet CustomXMLPart à la collection Microsoft.Office.Interop.Word._Document.CustomXMLParts* figurant dans le document.Add a new CustomXMLPart object to the Microsoft.Office.Interop.Word._Document.CustomXMLParts* collection in the document. CustomXMLPart contient la chaîne XML que vous souhaitez stocker dans le document.The CustomXMLPart contains the XML string that you want to store in the document.

    L'exemple de code suivant ajoute une partie XML personnalisée à un document spécifié.The following code example adds a custom XML part to a specified document.

    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
    
    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);
    }
    
  2. Ajoutez la méthode AddCustomXmlPartToDocument à la classe ThisAddIn dans un projet de complément VSTO pour Word.Add the AddCustomXmlPartToDocument method to the ThisAddIn class in an VSTO Add-in project for Word.

  3. Appelez cette méthode à partir d'un autre code dans votre projet.Call the method from other code in your project. Par exemple, pour créer la partie XML personnalisée quand l'utilisateur ouvre un document, appelez la méthode à partir d'un gestionnaire d'événements pour l'événement Microsoft.Office.Interop.Word.ApplicationEvents4_Event.DocumentOpen .For example, to create the custom XML part when the user opens a document, call the method from an event handler for the Microsoft.Office.Interop.Word.ApplicationEvents4_Event.DocumentOpen event.

Pour ajouter une partie XML personnalisée à une présentation PowerPointTo add a custom XML part to a PowerPoint presentation

  1. Ajoutez un nouvel objet CustomXMLPart à la collection Microsoft.Office.Interop.PowerPoint._Presentation.CustomXMLParts* figurant dans la présentation.Add a new CustomXMLPart object to the Microsoft.Office.Interop.PowerPoint._Presentation.CustomXMLParts* collection in the presentation. CustomXMLPart contient la chaîne XML que vous souhaitez stocker dans la présentation.The CustomXMLPart contains the XML string that you want to store in the presentation.

    L'exemple de code suivant ajoute une partie XML personnalisée à une présentation spécifiée.The following code example adds a custom XML part to a specified presentation.

    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);
    }
    
    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. Ajoutez la méthode AddCustomXmlPartToPresentation à la classe ThisAddIn dans un projet de complément VSTO pour PowerPoint.Add the AddCustomXmlPartToPresentation method to the ThisAddIn class in an VSTO Add-in project for PowerPoint.

  3. Appelez cette méthode à partir d'un autre code dans votre projet.Call the method from other code in your project. Par exemple, pour créer la partie XML personnalisée quand l'utilisateur ouvre une présentation, appelez la méthode à partir d'un gestionnaire d'événements pour l'événement Microsoft.Office.Interop.PowerPoint.EApplication_Event.AfterPresentationOpen .For example, to create the custom XML part when the user opens a presentation, call the method from an event handler for the Microsoft.Office.Interop.PowerPoint.EApplication_Event.AfterPresentationOpen event.

Programmation fiableRobust Programming

Par souci de simplicité, cet exemple utilise une chaîne XML définie comme variable locale dans la méthode.For simplicity, this example uses an XML string that is defined as a local variable in the method. En règle générale, vous devez obtenir le code XML auprès d'une source externe, telle qu'un fichier ou une base de données.Typically, you should obtain the XML from an external source, such as a file or a database.

Voir aussiSee Also

Custom XML Parts Overview Custom XML Parts Overview
Guide pratique pour ajouter des parties XML personnalisées aux personnalisations au niveau du documentHow to: Add Custom XML Parts to Document-Level Customizations