Comment : ajouter des parties XML personnalisées aux personnalisations au niveau du document

Article
03/04/2013

Pour stocker les données XML dans un classeur Microsoft Office Excel ou dans un document Microsoft Office Word, créez une partie XML personnalisée dans une personnalisation au niveau du document.Pour plus d’informations, consultez Vue d'ensemble des parties XML personnalisées.

S'applique à : Les informations contenues dans cette rubrique s'appliquent aux projets de niveau document pour les applications suivantes : Excel 2013, Excel 2010, Word 2013 et Word 2010. Pour en savoir plus, consultez Fonctionnalités disponibles par type d'application et de projet Office.

[!REMARQUE]

Visual Studio ne fournit pas de projets au niveau du document pour Microsoft Office PowerPoint.Pour plus d'informations sur l'ajout d'une partie XML personnalisée à une présentation PowerPoint à l'aide d'un complément au niveau de l'application, consultez Comment : ajouter des parties XML personnalisées à des documents à l'aide de compléments d'application.

Pour ajouter une partie XML personnalisée à un classeur Excel

Ajoutez un nouvel objet CustomXMLPart à la collection CustomXMLParts du classeur.CustomXMLPart contient la chaîne XML à stocker dans le classeur.

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);
}

Ajoutez la méthode AddCustomXmlPartToWorkbook à la classe ThisWorkbook dans un projet au niveau du document pour Excel.
Appelez la méthode à partir d'un autre code dans votre projet.Par exemple, pour créer la partie XML personnalisée lorsque l'utilisateur ouvre le classeur, appelez la méthode à partir du gestionnaire d'événements ThisWorkbook_Startup.

Pour ajouter une partie XML personnalisée à un document Word

Ajoutez un nouvel objet CustomXMLPart à la collection CustomXMLParts du document.CustomXMLPart contient la chaîne XML à stocker dans le document.

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);
}

Ajoutez la méthode AddCustomXmlPartToDocument à la classe ThisDocument dans un projet au niveau du document pour Word.
Appelez la méthode à partir d'un autre code dans votre projet.Par exemple, pour créer la partie XML personnalisée lorsque l'utilisateur ouvre le document, appelez la méthode à partir du gestionnaire d'événements ThisDocument_Startup.

Programmation fiable

Pour simplifier, cet exemple utilise une chaîne XML définie comme variable locale dans la méthode.En général, vous devez obtenir le code XML auprès d'une source externe, comme un fichier ou une base de données.

Voir aussi

Tâches

Comment : ajouter des parties XML personnalisées à des documents à l'aide de compléments d'application

Concepts

Vue d'ensemble des parties XML personnalisées

Partager via