Partager via

Ajouter des parties XML personnalisées aux personnalisations au niveau du document

  • Article

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. Pour plus d’informations, consultez vue d’ensemble des composants XML personnalisés.

S’applique à : les informations contenues dans cette rubrique s’appliquent aux projets au niveau du document pour Excel et Word. Pour plus d’informations, consultez Fonctionnalités disponibles par application Office lication et le type de projet.

Remarque

Visual Studio ne fournit pas de projets au niveau du document pour Microsoft Office PowerPoint. Pour plus d’informations sur l’ajout d’un composant XML personnalisé à une présentation PowerPoint à l’aide d’un complément VSTO, consultez Guide pratique pour ajouter des parties XML personnalisées à des documents à l’aide de compléments VSTO.

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

  1. Ajoutez un nouvel objet CustomXMLPart à la collection CustomXMLParts figurant dans le classeur. CustomXMLPart contient la chaîne XML que vous souhaitez stocker dans le classeur.

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

  2. Ajoutez la méthode AddCustomXmlPartToWorkbook à la classe ThisWorkbook dans un projet au niveau du document pour Excel.

  3. Appelez cette méthode à partir d'un autre code dans votre projet. 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 .

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

  1. Ajoutez un nouvel objet CustomXMLPart à la collection CustomXMLParts figurant dans le document. CustomXMLPart contient la chaîne XML que vous souhaitez stocker dans le document.

    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.

  3. Appelez cette méthode à partir d'un autre code dans votre projet. 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 .

Programmation fiable

Par souci de simplicité, cet exemple utilise une chaîne XML définie comme variable locale dans la méthode. 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.

Contenu connexe