Comment : ajouter des parties XML personnalisées aux personnalisations au niveau du documentHow to: Add custom XML parts to document-level customizations

Vous pouvez stocker des données XML dans un classeur Microsoft Office Excel ou un document Microsoft Office Word en créant une partie XML personnalisée dans une personnalisation au niveau du document.You can store XML data in a Microsoft Office Excel workbook or Microsoft Office Word document by creating a custom XML part in a document-level customization. Pour plus d’informations, consultez vue d’ensemble des parties XML personnalisées.For more information, see Custom XML parts overview.

S’applique à : Les informations contenues dans cette rubrique s’appliquent aux projets de niveau document pour Excel et Word.Applies to: The information in this topic applies to document-level projects for Excel and Word. Pour plus d’informations, consultez Fonctionnalités disponibles par type d’application et de projet Office.For more information, see Features Available by Office Application and Project Type.

Note

Visual Studio ne fournit pas de projets au niveau du document pour Microsoft Office PowerPoint.Visual Studio does not provide document-level projects for Microsoft Office PowerPoint. Pour plus d’informations sur l’ajout d’une partie XML personnalisée à une présentation PowerPoint en utilisant un complément VSTO dans, voir Comment : ajouter des parties XML personnalisées à des documents à l’aide de compléments VSTO.For information about adding a custom XML part to a PowerPoint presentation by using an VSTO Add-in, see How to: Add custom XML parts to documents by using VSTO Add-ins.

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 CustomXMLParts figurant dans le classeur.Add a new CustomXMLPart object to the 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.

    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);
    }
    
    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. Ajoutez la méthode AddCustomXmlPartToWorkbook à la classe ThisWorkbook dans un projet au niveau du document pour Excel.Add the AddCustomXmlPartToWorkbook method to the ThisWorkbook class in a document-level 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 le classeur, appelez la méthode à partir du gestionnaire d’événements ThisWorkbook_Startup .For example, to create the custom XML part when the user opens the workbook, call the method from the ThisWorkbook_Startup event handler.

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 CustomXMLParts figurant dans le document.Add a new CustomXMLPart object to the 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.

    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
    
    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);
    }
    
  2. Ajoutez la méthode AddCustomXmlPartToDocument à la classe ThisDocument dans un projet au niveau du document pour Word.Add the AddCustomXmlPartToDocument method to the ThisDocument class in a document-level 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 le document, appelez la méthode à partir du gestionnaire d’événements ThisDocument_Startup .For example, to create the custom XML part when the user opens the document, call the method from the ThisDocument_Startup event handler.

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

Vue d’ensemble des parties XML personnalisée Custom XML parts overview
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