Ajouter des parties XML personnalisées à des documents à l’aide de compléments VSTO

  • Article

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 :

  • un classeur Microsoft Office Excel,

  • un document Microsoft Office Word,

  • une présentation Microsoft Office PowerPoint.

    Pour plus d’informations, consultez vue d’ensemble des composants XML personnalisés.

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

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.

    L'exemple de code suivant ajoute une partie XML personnalisée à un classeur spécifié.

    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 AddCustomXmlPartToWorkbook méthode à la ThisAddIn classe dans un projet de complément VSTO 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 un classeur, appelez la méthode à partir d'un gestionnaire d'événements pour l'événement WorkbookOpen .

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.

    L'exemple de code suivant ajoute une partie XML personnalisée à un document spécifié.

    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 AddCustomXmlPartToDocument méthode à la ThisAddIn classe dans un projet de complément VSTO 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 un document, appelez la méthode à partir d'un gestionnaire d'événements pour l'événement DocumentOpen .

Pour ajouter une partie XML personnalisée à une présentation PowerPoint

  1. Ajoutez un nouvel CustomXMLPart objet à Microsoft.Bureau. collection Interop.PowerPoint._Presentation.CustomXMLParts dans la présentation. CustomXMLPart contient la chaîne XML que vous souhaitez stocker dans la présentation.

    L'exemple de code suivant ajoute une partie XML personnalisée à une présentation spécifiée.

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

  2. Ajoutez la AddCustomXmlPartToPresentation méthode à la ThisAddIn classe dans un projet de complément VSTO pour PowerPoint.

  3. Appelez cette méthode à partir d'un autre code dans votre projet. Par exemple, pour créer la partie XML personnalisée lorsque l’utilisateur ouvre une présentation, appelez la méthode à partir d’un gestionnaire d’événements pour Microsoft.Bureau. événement Interop.PowerPoint.EApplication_Event.AfterPresentationOpen.

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